teamworkSectionItem: move

名前空間: microsoft.graph

重要

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

ユーザーのチームワーク内のユーザー定義セクションから別のユーザー定義セクションに項目を移動する。 各アイテムは、一度に 1 つのセクションにのみ属することができます。 この操作により、アイテムが現在のセクションから削除され、ターゲット セクションに追加されます。

注:

アイテムを別のユーザー定義セクションに移動するには、 Add teamworkSectionItem API を使用することをお勧めします。 追加要求は、アイテムが別のユーザー定義セクションにある場合は移動します。

この 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/{teamworkSectionItem-id}/move

要求ヘッダー

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

要求本文

要求本文で、パラメーターの JSON 表現を指定します。

次の表に、このアクションを呼び出すときに必要なパラメーターを示します。

パラメーター 型 説明
targetSectionId 文字列 アイテムの移動先セクションの ID。 必須です。

応答

成功した場合、このアクションは 200 OK 応答コードと、ターゲット セクション内のアイテムを表す応答本文の teamworkSectionItem を返します。

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

応答コード メッセージ
400 Bad Request targetSectionId プロパティは必須であり、空にすることはできません。
400 Bad Request ソース セクションとターゲット セクションは異なる必要があります。
403 Forbidden このセクションはシステムによって生成されたものであり、変更できません。 このアクションを使用して、システム定義セクション内外にアイテムを移動することはできません。
404 Not Found 指定したセクションが見つからないか、指定されたアイテムがこのセクションに見つかりませんでした。
409 Conflict 同時変更のため、このセクションを更新できません。 要求を再試行してください。

例

要求

次の例は、チャットを "お気に入り" セクションから "Project Alpha" セクションに移動する要求を示しています。

POST 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/move
Content-type: application/json

{
  "targetSectionId": "c3d4e5f6-a7b8-9012-cdef-123456789012"
}

応答

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

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

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

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