英語で読む

次の方法で共有


team リソースの種類

名前空間: microsoft.graph

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 メンバーを所有者または通常のメンバーに変更します。
メンバーを削除する なし チームから既存のメンバーを削除します。
チームをアーカイブする teamsAsyncOperation チームを読み取り専用状態にします。
チームを展開する teamsAsyncOperation チームを読み取り/書き込み状態に復元します。
チームを複製する teamsAsyncOperation チームとその関連グループをコピーします。
チームを一覧表示する team コレクション メンバーであるチームの一覧を表示します。
関連付けられたチームを一覧表示する associatedTeamInfo コレクション ユーザー が関連付けられている Microsoft Teams の チーム の一覧を取得します。
組織内のすべてのチームを一覧表示する team コレクション 組織内のすべてのチームを一覧表示します。
チームの完全な移行 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)"
}