Вывод списка элементов cloudClipboard

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

Получите список объектов cloudClipboardItem и их свойств для пользователя. Этот API позволяет получить объекты cloudClipboardItem только для:

• Собственные объекты cloudClipboardItem пользователя, выполнившего вход.
• Приложение от имени пользователя, если пользователь предоставляет ему делегированный доступ.

Этот API не поддерживает использование учетных данных другого пользователя для получения cloudClipboardItem для пользователя.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба	Правительство США L4	Правительство США L5 (DOD)	Китай управляется 21Vianet
✅	❌	❌	❌

Разрешения

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

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

HTTP-запрос

GET /me/cloudClipboard/items

Необязательные параметры запросов

Этот метод поддерживает $skipTokenпараметры запроса OData для настройки ответа.

$skipToken — это маркер, возвращенный в @odata.nextLink URL-адресе в ответе на предыдущий запрос List, который указывает на то, что пользователю нужно получить больше объектов cloudClipboardItem .

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

Имя	Описание
Авторизация	Bearer {token}. Обязательно.
Prefer	odata.maxpagesize={x}. Необязательный параметр. Задает предпочтительный размер страницы с целым числом {x} для результатов с разбивкой на страницы. Допустимые значения: от 1 до 200 включительно. Если в заголовке не указано, размер страницы по умолчанию равен 110.

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

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

Отклик

В случае успешного 200 OK выполнения этот метод возвращает код отклика и коллекцию объектов cloudClipboardItem в теле отклика.

Ошибки

Помимо общих ошибок , которые применяются к Microsoft Graph, некоторые условия ошибок относятся к API облачного буфера обмена.

Код состояния	Сообщение о состоянии	Описание
400	Недопустимый запрос	Неправильный или неправильный запрос, например недопустимый размер страницы или недопустимое $skipToken значение.
403	Запрещено	Вызывающий не может выполнить действие. Это означает, что пользователь не согласился предоставить общий доступ к cloudClipboardItem.
409	Conflict	Текущее состояние противоречит ожидаемым результатам запроса. Обычно это означает, что пользователь не имеет права на использование функции облачного буфера обмена, так как во время входа у него нет по крайней мере двух устройств, прошедших проверку подлинности с помощью многофакторной проверки подлинности.
429	Слишком много запросов	Превышен предел частоты запросов. Подождите время, указанное в заголовке, Retry-After и повторите попытку.

Примеры

Запрос

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

GET https://graph.microsoft.com/v1.0/user/cloudClipboard/items

Отклик

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

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

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

{
  "value": [
    {
      "@odata.type": "#microsoft.graph.cloudClipboardItem",
      "id": "292bcf2f-b37e-49d0-8882-1e33dd5c2273",
      "payloads": [
        {
          "@odata.type": "microsoft.graph.cloudClipboardItemPayload",
          "content": "aGVsbG8sIHdvcmxkIQ==",
          "formatName": "TextBase64"
        }
      ],
      "createdDateTime": "2023-08-10T16:56:25.413Z",
      "lastModifiedDateTime": "2022-06-06T17:04:58.000Z",
      "expirationDateTime": "2023-08-11T04:56:25.387Z"
    }
  ],
  "@odata.nextLink": "https://graph.microsoft.com/v1.0/me/cloudClipboard/items?$skiptoken=lastModifiedDateTime%20le%202024-01-31T01:14:29.675Z"
}