Calendario: delta

Espacio de nombres: microsoft.graph

Obtener un conjunto de recursos de calendario agregados, actualizados o eliminados en el buzón de un usuario.

Normalmente, la sincronización de calendarios en un buzón de una tienda local implica una ronda de varias llamadas de función delta . La llamada inicial es una sincronización completa y cada llamada delta posterior en la misma ronda obtendrá los cambios incrementales (adiciones, eliminaciones o actualizaciones). El uso de deltas le permite mantener y sincronizar de forma incremental un almacén local de calendarios en el buzón especificado.

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Solicitud HTTP

Para comenzar a realizar un seguimiento de los cambios, realice una solicitud que incluya la función delta en el recurso de calendario.

Para realizar cambios incrementales en la lista de calendarios del buzón del usuario.

GET /me/calendars/delta
GET /users/{usersId}/calendars/delta

Parámetros de consulta

El seguimiento de cambios implica una ronda de una o más llamadas a la función delta . Si usa cualquier parámetro de consulta (distinto de $deltatoken y $skiptoken), debe especificarlo en la solicitud delta inicial. Microsoft Graph codifica automáticamente los parámetros especificados en la parte del token de la dirección URL @odata.nextLink o @odata.deltaLink proporcionada en la respuesta.

Especifique los parámetros de consulta deseados solo en la solicitud inicial.

En solicitudes posteriores, use la dirección URL @odata.nextLink o @odata.deltaLink de la respuesta anterior. La dirección URL ya incluye los parámetros de consulta codificados.

Parámetros de consulta opcionales

Este método admite parámetros de consulta OData opcionales para ayudar a personalizar la respuesta.

• Puede usar un $select parámetro de consulta como en cualquier solicitud GET para especificar solo las propiedades que necesita para obtener el mejor rendimiento.
• La función delta no admite los siguientes parámetros de consulta: $expand, $filter, $orderbyy $search.

Encabezados de solicitud

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se realiza correctamente, esta función devuelve un 200 OK código de respuesta y una colección de objetos de calendario en el cuerpo de la respuesta.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra una solicitud sin el $select parámetro; se realiza un seguimiento y se devuelve un conjunto predeterminado de propiedades.

GET https://graph.microsoft.com/v1.0/me/calendars/delta

Respuesta

Si la solicitud es correcta, la respuesta incluye un token de estado, que es a $skipToken (en un encabezado de respuesta @odata.nextLink ) o un $deltaToken (en un encabezado de respuesta @odata.deltaLink ). Respectivamente, indican si debe continuar con la ronda o si terminó de obtener todos los cambios para esa ronda.

La siguiente respuesta muestra un $deltaToken en un encabezado de respuesta @odata.deltaLink .

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 200 OK
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(calendar)",
    "value": [
        {
            "@odata.type": "#microsoft.graph.calendar",
            "id": "AQMkADRhZThkMDVjLTJmNDctNDUyZC05YjA2LTI2YzRmMTIxOWJhZQBGAAADVDIMnvGkNkGo5_ASLe7iUQcAvXegGcyc-0O1dA1ftrtB6QAAAgEGAAAAvXegGcyc-0O1dA1ftrtB6QAAAUSwewAAAA==",
            "name": "Calendar",
            "color": "auto",
            "hexColor": "",
            "groupClassId": "0006f0b7-0000-0000-c000-000000000046",
            "isDefaultCalendar": true,
            "changeKey": "vXegGcyc/0O1dA1ftrtB6QAAAEO+6Q==",
            "canShare": true,
            "canViewPrivateItems": true,
            "isShared": false,
            "isSharedWithMe": false,
            "canEdit": true,
            "calendarGroupId": null,
            "allowedOnlineMeetingProviders": [
                "teamsForBusiness"
            ],
            "defaultOnlineMeetingProvider": "teamsForBusiness",
            "isTallyingResponses": true,
            "isRemovable": false,
            "owner": {
                "name": "Samantha Booth",
                "address": "samanthab@contoso.com"
            }
        },
        {
            "@odata.type": "#microsoft.graph.calendar",
            "id": "AQMkADRhZThkMDVjLTJmNDctNDUyZC05YjA2LTI2YzRmMTIxOWJhZQBGAAADVDIMnvGkNkGo5_ASLe7iUQcAvXegGcyc-0O1dA1ftrtB6QAAAgEGAAAAvXegGcyc-0O1dA1ftrtB6QAAAU4pOwAAAA==",
            "name": "Birthdays",
            "color": "auto",
            "hexColor": "",
            "groupClassId": "0006f0b7-0000-0000-c000-000000000046",
            "isDefaultCalendar": false,
            "changeKey": "vXegGcyc/0O1dA1ftrtB6QAAAEzvog==",
            "canShare": false,
            "canViewPrivateItems": true,
            "isShared": false,
            "isSharedWithMe": false,
            "canEdit": false,
            "calendarGroupId": null,
            "allowedOnlineMeetingProviders": [],
            "defaultOnlineMeetingProvider": "unknown",
            "isTallyingResponses": false,
            "isRemovable": true,
            "owner": {
                "name": "Samantha Booth",
                "address": "samanthab@contoso.com"
            }
        }
    ],
    "@odata.deltaLink": "https://graph.microsoft.com/v1.0/me/calendars/delta?$deltatoken=LztZwWjo5IivWBhyxw5rAIPrk_3pGHcZr4U33FHo0HpyBLqdo9QZIWfEL4AW1jMLBmo-o1ybmYCWlzQ5elO2bEDejh9Z8kYv_z4nhmHoC5Y.7Wdj3MWiils6M--JMM9dMyiLCh-1he4AZCqBu-8i42o"
}