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

Добавление вложения

  • Статья

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Добавление вложения при создании записи группы.

Эта операция ограничивает размер вложения, в который можно добавить, до 3 МБ.

Допустимые типы вложений:

  • файл (ресурс fileAttachment);
  • элемент (контакт, событие или сообщение, представленные ресурсом itemAttachment);
  • ссылка на файл (ресурс referenceAttachment).

Все эти типы ресурсов вложений являются производными от ресурса attachment.

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

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

Разрешения

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

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

HTTP-запрос

Включите вложение при создании записи в conversationThread группы. Указание родительского диалога является необязательным.

POST /groups/{id}/threads/{id}/reply
POST /groups/{id}/conversations/{id}/threads/{id}/reply

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

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

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

В тексте запроса укажите объект JSON, включающий параметр post .

Параметр Тип Описание
post post Новая запись, на которую отправляется ответ, которая включает одно или несколько вложений в коллекции вложений .

Отклик

В случае успешного выполнения этот метод возвращает код отклика 202 Accepted. Он не возвращает текст ответа.

Примеры

Пример 1. Включение вложения файла

Запрос

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

POST https://graph.microsoft.com/beta/groups/1848753d-185d-4c08-a4e4-6ee40521d115/threads/AAQkADJUdfolA==/reply
Content-type: application/json

{
  "post": {
    "body": {
      "contentType": "text",
      "content": "Which quarter does that file cover? See my attachment."
    },
    "attachments": [{
      "@odata.type": "#microsoft.graph.fileAttachment",
      "name": "Another file as attachment",
      "contentBytes": "VGhpcyBpcyBhIGZpbGUgdG8gYmUgYXR0YWNoZWQu"
    } ]
  }
}

Отклик

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

HTTP/1.1 202 Accpted

Пример 2. Включение вложения элемента

Запрос

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

POST https://graph.microsoft.com/beta/groups/1848753d-185d-4c08-a4e4-6ee40521d115/threads/AAQkADJUdfolA==/reply
Content-type: application/json

{
  "post": {
    "body": {
      "contentType": "text",
      "content": "I attached an event."
    },
    "attachments": [{
      "@odata.type": "#microsoft.graph.itemAttachment",
      "name": "Holiday event", 
      "item": {
          "@odata.type": "microsoft.graph.event",
          "subject": "Discuss gifts for children",
          "body": {
              "contentType": "HTML",
              "content": "Let's look for funding!"
          },
          "start": {
              "dateTime": "2019-12-02T18:00:00",
              "timeZone": "Pacific Standard Time"
          },
          "end": {
              "dateTime": "2019-12-02T19:00:00",
              "timeZone": "Pacific Standard Time"
          }
      }
    } ]
  }
}

Отклик

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

HTTP/1.1 202 Accepted

Пример 3. Включение ссылочного вложения

Запрос

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

POST https://graph.microsoft.com/beta/groups/1848753d-185d-4c08-a4e4-6ee40521d115/threads/AAQkADJUdfolA==/reply
Content-type: application/json

{
  "post": {
    "body": {
      "contentType": "text",
      "content": "I attached a reference to a file on OneDrive."
    },
    "attachments": [{
      "@odata.type": "#microsoft.graph.referenceAttachment", 
      "name": "Personal pictures", 
      "sourceUrl": "https://contoso.com/personal/mario_contoso_net/Documents/Pics", 
      "providerType": "oneDriveConsumer", 
      "permission": "Edit", 
      "isFolder": "True"
    } ]
  }
}

Отклик

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

HTTP/1.1 202 Accpted