添付ファイルを追加する

名前空間: microsoft.graph

グループ投稿を作成するときに 添付ファイル を追加します。

この操作では、追加できる添付ファイルのサイズが 3 MB 未満に制限されます。

添付ファイルには、次の種類のいずれかを指定できます。

これらの添付ファイル リソースのすべての種類は、attachment リソースから派生します。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国
✅ ✅ ✅ ✅

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント) Group.ReadWrite.All
委任 (個人用 Microsoft アカウント) サポートされていません。
アプリケーション サポートされていません。

HTTP 要求

conversationThread of a group で投稿を作成するときに添付ファイルを含めます。 親 会話 の指定は省略可能です。

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

要求ヘッダー

ヘッダー 値
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。

要求本文

要求本文で、 post パラメーターを含む JSON オブジェクトを指定します。

パラメーター 型 説明
post post 返信される新しい投稿。添付ファイル コレクションに 1 つ以上の 添付ファイル が含まれています。

応答

成功した場合、このメソッドは 202 Accepted 応答コードを返します。 応答本文は返されません。

例

例 1: 添付ファイルを含める

要求

次の例は、投稿の作成時に添付ファイルを添付ファイルとして含む要求を示しています。

POST https://graph.microsoft.com/v1.0/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 Accepted

例 2: アイテムの添付ファイルを含める

要求

次の例は、投稿の作成時に添付ファイルとしてイベントを含む要求を示しています。

POST https://graph.microsoft.com/v1.0/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/v1.0/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 Accepted