Поделиться через

Получение cloudClipboardItem

  • Статья

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

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

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

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

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

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

Разрешения

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

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

HTTP-запрос

GET /me/cloudClipboard/items/{cloudClipboardItemId}

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

Этот метод не поддерживает параметры запроса OData для настройки повторного выполнения. Общие сведения см. в статье Параметры запроса OData.

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

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

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

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

Отклик

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

Ошибки

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

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

Примеры

Запрос

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

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

Отклик

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

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

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

{
  "@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"
}