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