Примечание: дельта

Пространство имен: microsoft.graph

Получите набор объектов заметок , которые были добавлены, обновлены или удалены в папке "Заметки " пользователя со времени последнего разностного запроса. Вызов разностной функции для заметок аналогичен запросу GET, за исключением того, что, соответствующим образом применяя маркеры состояния в одном или нескольких из этих вызовов, можно запрашивать добавочные изменения в заметках.

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более высокий уровень привилегий или разрешений, только если это требуется вашему приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в статье Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшим объемом привилегий Разрешения с более высоким уровнем привилегий
Делегированные (рабочая или учебная учетная запись) ShortNotes.Read ShortNotes.ReadWrite
Делегированные (личная учетная запись Майкрософт) ShortNotes.Read ShortNotes.ReadWrite
Для приложений Не поддерживается. Не поддерживается.

HTTP-запрос

GET /me/notes/delta
GET /users/{id | userPrincipalName}/notes/delta

Параметры запроса

Для записи изменений в примечаниях выполняется один или несколько вызовов дельта-функции . Если вы используете параметры запроса, отличные от $deltatoken и $skiptoken, их необходимо указать в начальном запросе delta. Microsoft Graph автоматически кодирует все указанные параметры в части маркера URL-адреса @odata.nextLink или @odata.deltaLink , указанного в ответе.

Параметр запроса Тип Описание
$deltatoken String Маркер состояния, возвращаемый в URL-адресе @odata.deltaLink предыдущего вызова функции Delta, указывающий на завершение этого раунда отслеживания изменений. Сохраните и примените весь URL-адрес @odata.deltaLink , включая этот маркер, в первом запросе следующего раунда отслеживания изменений для этой коллекции.
$skiptoken String Маркер состояния, возвращаемый в URL-адресе @odata.nextLink предыдущего вызова разностной функции, указывающий на дальнейшие изменения, которые необходимо отследить.

Этот метод также поддерживает параметры запросов $select, $filter, $orderby, и $top OData, что помогает настраивать ответ.

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения об аутентификации и авторизации.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успеха этот метод возвращает код отклика 200 OK и коллекцию объектов примечания в тексте ответа. Ответ также включает URL-адрес @odata.nextLink или URL-адрес @odata.deltaLink .

  • Если возвращается URL-адрес @odata.nextLink , остается извлечь дополнительные страницы данных. Приложение продолжает выполнять запросы с использованием URL-адреса @odata.nextLink до тех пор, пока URL-адрес @odata.deltaLink не будет включен в отклик.
  • Если возвращается URL-адрес @odata.deltaLink , возвращаемые страницы данных больше не остаются. Сохраните URL-адрес @odata.deltaLink для использования в следующем разностном вызове.

Примеры

Пример 1. Первоначальный запрос на синхронизацию

В следующем примере показан первоначальный запрос на синхронизацию для получения всех заметок.

Запрос

Ниже показан пример запроса.

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

Отклик

Ниже показан пример отклика.

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

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('user-id')/notes",
  "@odata.deltaLink": "https://graph.microsoft.com/v1.0/me/notes/delta?$deltatoken=abc123def456",
  "value": [
    {
      "id": "AAMkAGI2THVSAAA=",
      "changeKey": "CQAAABYAAABE",
      "createdDateTime": "2024-01-15T10:00:00Z",
      "lastModifiedDateTime": "2024-01-20T11:00:00Z",
      "categories": [],
      "subject": "Updated Note",
      "body": {
        "contentType": "html",
        "content": "<html><body>Updated content</body></html>"
      },
      "bodyPreview": "Updated content",
      "isDeleted": false,
      "hasAttachments": false
    }
  ]
}

Пример 2. Последующий разностный запрос

В следующем примере показан последующий запрос на синхронизацию с использованием разностного маркера из предыдущего ответа. Возвращаются новые, обновленные и удаленные заметки.

Запрос

Ниже показан пример запроса.

GET https://graph.microsoft.com/v1.0/me/notes/delta?$deltatoken=abc123def456

Отклик

Ниже приводится пример отклика.

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

{
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('user-id')/notes",
  "@odata.deltaLink": "https://graph.microsoft.com/v1.0/me/notes/delta?$deltatoken=xyz789new",
  "value": [
    {
      "id": "AAMkAGI2NEWITEM=",
      "changeKey": "CQAAABYAAABF",
      "subject": "New Note",
      "bodyPreview": "New content",
      "createdDateTime": "2024-01-21T08:00:00Z",
      "lastModifiedDateTime": "2024-01-21T08:00:00Z"
    },
    {
      "@removed": {
        "reason": "deleted"
      },
      "id": "AAMkAGI2DELETED="
    }
  ]
}
  • Last updated on