team リソースの種類
名前空間: microsoft.graph
Microsoft Teams のチームは、channel オブジェクトのコレクションです。 チャネルは 1 つのトピック、つまりチーム内でのディスカッションの論理的分離を表します。
各チームには Microsoft 365 グループが関連付けられています。
グループでは、チームと同じ ID を持ちます。例えば、/groups/{id}/teamと/teams/{id}が同じになります。
チームのメンバーおよびグループの操作の詳細については、「Microsoft Graph REST API を使用して Microsoft Teams を操作する」を参照してください。
メソッド
| メソッド | 戻り値の型 | 説明 |
|---|---|---|
| チームを作成する | teamsAsyncOperation | チームを新規に作成します。 |
| グループからチームを作成する | team | 新しいチームを作成するか、既存の Microsoft 365 グループにチームを追加します。 |
| チームを取得する | team | 指定したチームのプロパティとリレーションシップを取得します。 |
| チームを更新する | team | 指定されたチームのプロパティを更新します。 |
| チームを削除する | なし | チームとその関連グループを削除します。 |
| メンバーを一覧表示する | conversationMember コレクション | チームのメンバーの一覧を取得します。 |
| メンバーを追加する | conversationMember | チームに新しいメンバーを追加します。 |
| メンバーをまとめてチームに追加します | actionResultPart コレクション | 1 つの要求でチームに複数のメンバーを追加する |
| メンバーを取得する | conversationMember コレクション | チームのメンバーを取得します。 |
| プライマリ チャネルを取得する | channel | チームの全般チャネル。 |
| メンバーの役割を更新する | conversationMember | メンバーを所有者または通常のメンバーに変更します。 |
| メンバーを削除する | なし | チームから既存のメンバーを削除します。 |
| チームをアーカイブする | teamsAsyncOperation | チームを読み取り専用状態にします。 |
| チームを展開する | teamsAsyncOperation | チームを読み取り/書き込み状態に復元します。 |
| チームを複製する | teamsAsyncOperation | チームとその関連グループをコピーします。 |
| チームを一覧表示する | team コレクション | メンバーであるチームの一覧を表示します。 |
| 関連付けられているチームを一覧表示する | associatedTeamInfo コレクション | ユーザー が関連付けられている Microsoft Teams の チーム の一覧を取得します。 |
| 組織内のすべてのチームを一覧表示する | team コレクション | 組織内のすべてのチームを一覧表示します。 |
| Complete migration | team | チームの移行モードを削除して、ユーザーがメッセージを投稿および読めるように、チームの使用を可能にします。 |
| すべてのチャネルを一覧表示する | channel コレクション | このチーム内またはこのチームと共有されているチャネル (受信チャネル) の一覧を取得します。 |
| チャネルを一覧表示する | channel コレクション | チーム内のチャネルの一覧を取得します。 |
| 受信チャネルを一覧表示する | channel コレクション | 受信チャネル (チームと共有されているチャネル) の一覧を取得します。 |
| 受信チャネルを削除する | なし | チームから受信チャネル (チームと共有されているチャネル) を削除します。 |
| チームにインストールされたアプリを一覧表示する | teamsAppInstallation コレクション | チームにインストールされているアプリを一覧表示します。 |
| アプリをチームに追加する | なし | チームにアプリを追加 (インストール) する |
| チームにアプリをインストールします | teamsAppInstallation | 指定したアプリをチームにインストールします。 |
| チームにインストールされたアプリをアップグレードする | なし | チームにインストールされているアプリを最新バージョンにアップグレードします。 |
| チームからアプリを削除する | なし | チームからアプリを削除 (アンインストール) します。 |
| 権限付与の表示 | resourceSpecificPermissionGrant コレクション | アクセスがチームにアクセスするために付与されたアクセス許可を表示します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| id | string | チームの一意識別子。 グループの ID はチームと同じです。 このプロパティは読み取り専用であり、基本エンティティ型から継承されます。 |
| classification | string | 省略可能なラベル。 通常、チームのデータまたはビジネスの機密度を記述します。 テナントのディレクトリで事前に構成されているセットのいずれかに一致する必要があります。 |
| classSettings | teamClassSettings | クラスの設定を構成します。 チームがクラスを表している場合のみ使用できます。 |
| createdDateTime | dateTimeOffset | チームが作成されたときのタイムスタンプ。 |
| 説明 | string | チームに関するオプションの説明。 最大文字数は 1024 文字です。 |
| displayName | string | チームの名前。 |
| funSettings | teamFunSettings | チームでの Giphy、ミーム、およびステッカーの使用を構成する設定。 |
| guestSettings | teamGuestSettings | ゲストがチームでチャネルを作成、更新、削除できるかどうかを構成する設定。 |
| InternalId | string | 監査ログまたは Office 365 マネージメント アクティビティ API など、いくつかの場所で使用されているチームの一意の ID。 |
| isArchived | Boolean | このチームが読み取り専用モードかどうか。 |
| memberSettings | teamMemberSettings | メンバーが特定のアクション (チャネルの作成、ボットの追加など) をチーム内で実行できるかどうかを構成する設定。 |
| messagingSettings | teamMessagingSettings | チームでメッセージとメンションを構成する設定。 |
| specialization | teamSpecialization | 省略可能。 チームが特定のユース ケースを目的としているかどうかを示します。 チーム専門分野ごとに、ユース ケースをターゲットとする一意の動作とエクスペリエンスにアクセスできます。 |
| 概要 | teamSummary | 所有者、メンバー、ゲストの数など、チームに関する要約情報が含まれています。 |
| tenantId | string | Microsoft Entra テナントの ID。 |
| visibility | teamVisibilityType | グループとチームの可視性。 既定では Public です。 |
| webUrl | string (読み取り専用) | Microsoft Teams クライアントのチームに移動するハイパーリンク。 これは、Microsoft Teams クライアントでチームを右クリックし、[Get link to team] を選択すると作成される URL です。 この URL は不透明 blob として扱われる必要があり、また解析されません。 |
インスタンスの属性
インスタンスの属性は、動作が特殊なプロパティです。 これらのプロパティは一時的なものであり、a) サービスの動作を定義するか、b) 短期的なプロパティの値 (有効期限を持つアイテムのダウンロード URL など) を提供します。
| プロパティ名 | 種類 | 説明 |
|---|---|---|
| @microsoft.graph.teamCreationMode | string | チームが移行の状態にあり、現在移行の目的で使用されていることを示します。 1 つの値 migration を受け入れます。 注: 今後、Microsoft は、インポートされるデータの量に基づいて、お客様またはお客様の顧客に追加料金の支払いを要求する場合があります。 |
POST リクエストの例については、「リクエスト （移行状態でチームを作成する）」をご覧ください。
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| allChannels | channel コレクション | チームでホストされているか、チームと共有されているチャネルのリスト (受信チャネル)。 |
| channels | channel コレクション | チームに関連付けられているチャネルとメッセージのコレクション。 |
| incomingChannels | channel コレクション | チームと共有されている チャネル の一覧。 |
| installedApps | teamsAppInstallation コレクション | このチームにインストールされているアプリ。 |
| members | conversationMember コレクション | チームのメンバーと所有者。 |
| 操作 | teamsAsyncOperation コレクション | このチームで実行済みまたは実行中の非同期操作です。 |
| photo | profilePhoto | チームのプロフィール写真。 |
| primaryChannel | channel | チームの全般チャネル。 |
| schedule | schedule | このチームのシフトのスケジュール。 |
| tags | teamworkTag コレクション | チームに関連付けられているタグ。 |
| template | teamsTemplate | このチームの作成元テンプレート。 使用可能なテンプレートを参照してください。 |
| permissionGrants | resourceSpecificPermissionGrant コレクション | アクセスがチームにアクセスするために付与されたアクセス許可のコレクション。 |
JSON 表記
リソースの JSON 表記を次に示します。
注: チームがタイプ クラスである場合は、classSettings プロパティがチームに適用されます。
{
"classSettings": {"@odata.type": "microsoft.graph.teamClassSettings"},
"classification": "String",
"createdDateTime": "DateTimeOffset",
"description": "String",
"displayName": "String",
"funSettings": {"@odata.type": "microsoft.graph.teamFunSettings"},
"guestSettings": {"@odata.type": "microsoft.graph.teamGuestSettings"},
"internalId": "String",
"isArchived": "Boolean",
"memberSettings": {"@odata.type": "microsoft.graph.teamMemberSettings"},
"messagingSettings": {"@odata.type": "microsoft.graph.teamMessagingSettings"},
"specialization": "String",
"tenantId": "String",
"visibility": "String",
"webUrl": "String (URL)"
}
関連コンテンツ
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示