チームワークセクション項目の追加

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

チャット、チャネル、会議、コミュニティなどのアイテムをユーザーのチームワークのユーザー定義セクションに追加します。 アイテムは一度に 1 つのセクションにのみ属することができます。 アイテムが別のユーザー定義セクションにある場合、この要求はアイテムをターゲット セクションに移動します。 アイテムが既にターゲット セクション内にある場合、要求は変更を加えずに成功します。

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

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

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) TeamworkSection.ReadWrite 注意事項なし。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション TeamworkSection.ReadWrite.All Teamwork.Migrate.All

HTTP 要求

POST /users/{user-id}/teamwork/sections/{teamworkSection-id}/items

要求ヘッダー

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

要求本文

要求本文には、 teamworkSectionItem オブジェクトの JSON 表現を指定します。

次の表に、 teamworkSectionItem を追加するときに設定できるプロパティを示します。

プロパティ 型 説明
id 文字列 セクションに追加するチャット、チャネル、会議、コミュニティの会話 ID。 コミュニティ (Viva Engage) 項目の場合は、コミュニティを一覧表示するときに返される最小限のコミュニティ ID (たとえば、eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxOTAzMzYyMTIyMTAifQ) または完全な19:{communityId}@EngageCommunityスレッド ID のいずれかを指定できます。 最小限のコミュニティ ID を指定すると、サービスによって自動的に 19:{communityId}@EngageCommunity 形式に正規化されます。スレッド プレフィックスを既に含んでいる ID がそのまま使用されます。 必須です。

応答

成功した場合、このメソッドは応答本文で 201 Created 応答コードと teamworkSectionItem オブジェクトを返します。

次のエラーが発生する可能性があります。

応答コード メッセージ
400 Bad Request 'id' プロパティは必須であり、空にすることはできません。
400 Bad Request 指定されたアイテム ID が無効です。 有効なチャット、チャネル、会議、またはコミュニティ ID を指定します。
400 Bad Request このセクションの最大項目数に達しました。
403 Forbidden このリソースへのアクセスは拒否されています。 発信者は、追加される会話のメンバーである必要があります。
404 Not Found 指定されたセクションが見つかりませんでした。
409 Conflict 同時変更のため、このセクションを更新できません。 要求を再試行してください。

例

例 1: セクションにチャットを追加する

次の例は、セクションにチャットを追加する方法を示しています。

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890/items
Content-type: application/json

{
  "id": "19:d5b2c3a4-e6f7-8901-abcd-ef3456789012@thread.v2"
}

応答

次の例は応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 201 Created
Content-type: application/json
Location: https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890/items/19:d5b2c3a4-e6f7-8901-abcd-ef3456789012@thread.v2

{
  "@odata.type": "#microsoft.graph.teamworkSectionItem",
  "@odata.etag": "\"1742515210\"",
  "id": "19:d5b2c3a4-e6f7-8901-abcd-ef3456789012@thread.v2",
  "itemType": "chat",
  "createdDateTime": "2026-03-08T10:00:00Z",
  "lastModifiedDateTime": null
}

例 2: セクションにコミュニティを追加する

次の例は、セクションに Viva Engage コミュニティを追加する方法を示しています。 リクエストは、 コミュニティをリストしたときに返される最小限のコミュニティ ID を提供します。 サービスは、コミュニティ ID を応答で返される 19:{communityId}@EngageCommunity 形式に正規化します。

要求

次の例は要求を示しています。

POST https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890/items
Content-type: application/json

{
  "id": "eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxOTAzMzYyMTIyMTAifQ"
}

応答

次の例は応答を示しています。 id プロパティは正規化された 19:{communityId}@EngageCommunity 形式で返されます。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 201 Created
Content-type: application/json
Location: https://graph.microsoft.com/beta/users/10f8c3a6-3e2a-4e8b-9c7d-5a4b6c8d9e0f/teamwork/sections/a1b2c3d4-e5f6-7890-abcd-ef1234567890/items/19:eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxOTAzMzYyMTIyMTAifQ@EngageCommunity

{
  "@odata.type": "#microsoft.graph.teamworkSectionItem",
  "@odata.etag": "\"1742515220\"",
  "id": "19:eyJfdHlwZSI6Ikdyb3VwIiwiaWQiOiIxOTAzMzYyMTIyMTAifQ@EngageCommunity",
  "itemType": "community",
  "createdDateTime": "2026-03-08T10:05:00Z",
  "lastModifiedDateTime": null
}
  • 最終更新: