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 を操作する」を参照してください。

メソッド

メソッド 戻り値の型 説明
チームを作成する teamsAsyncOperation チームを新規に作成します。
グループからチームを作成する team 新しいチームを作成するか、既存の Microsoft 365 グループにチームを追加します。
チームを取得する team 指定したチームのプロパティとリレーションシップを取得します。
チームを更新する team 指定されたチームのプロパティを更新します。
チームを削除する なし チームとその関連グループを削除します。
メンバーを一覧表示する conversationMember コレクション チームのメンバーの一覧を取得します。
メンバーを追加する conversationMember チームに新しいメンバーを追加します。
メンバーをまとめてチームに追加します actionResultPart コレクション 1 つの要求でチームに複数のメンバーを追加する
メンバーを取得する conversationMember コレクション チームのメンバーを取得します。
プライマリ チャネルを取得する channel チームの全般チャネル。
メンバーの役割を更新する conversationMember メンバーを所有者または通常のメンバーに変更します。
メンバーを削除する なし チームから既存のメンバーを削除します。
チームをアーカイブする teamsAsyncOperation チームを読み取り専用状態にします。
チームを展開する teamsAsyncOperation チームを読み取り/書き込み状態に復元します。
チームを複製する teamsAsyncOperation チームとその関連グループをコピーします。
チームを一覧表示する team コレクション メンバーであるチームを一覧表示します。
関連付けられているチームを一覧表示する associatedTeamInfo コレクション ユーザーが関連付けられている Microsoft Teams の associatedTeamInfo オブジェクトの一覧を取得します。
組織内のすべてのチームを一覧表示する team コレクション 組織内のすべてのチームを一覧表示します。
チームの写真を取得する バイナリ型データ チームの写真 (画像) を取得します。
Complete migration team チームの移行モードを削除して、ユーザーがメッセージを投稿および読めるように、チームの使用を可能にします。
すべてのチャネルを一覧表示する channel コレクション このチーム内またはこのチームと共有されているチャネル (受信チャネル) の一覧を取得します。
チャネルを一覧表示する channel コレクション チーム内のチャネルの一覧を取得します。
受信チャネルを一覧表示する channel コレクション チームと共有されているチャネルの一覧を取得します。
受信チャネルを削除する なし チームから受信チャネル (チームと共有されているチャネル) を削除します。
チームにインストールされたアプリを一覧表示する teamsAppInstallation コレクション チームにインストールされているアプリを一覧表示します。
アプリをチームに追加する なし チームにアプリを追加 (インストール) する
チームにアプリをインストールします teamsAppInstallation 指定したアプリをチームにインストールします。
チームにインストールされたアプリをアップグレードする なし チームにインストールされているアプリを最新バージョンにアップグレードします。
チームからアプリを削除する なし チームからアプリを削除 (アンインストール) します。
権限付与の表示 resourceSpecificPermissionGrant コレクション チームにアクセスするためのアプリに付与されるアクセス許可を一覧表示します。
参加しているすべてのチームでオープン シフトを取得する openShift コレクション ユーザーが直接メンバーであるすべてのチームにわたって 、すべての openShift オブジェクトを取得します。
参加しているすべてのチーム間でシフトを取得する shift コレクション ユーザーが直接メンバーであるすべてのチームにわたって、すべての シフト オブジェクトを取得します。
参加しているすべてのチームで休暇を取得する timeOff コレクション ユーザーが直接メンバーであるすべてのチームにわたって、すべての timeOff オブジェクトを取得します。

プロパティ

プロパティ 型 説明
id string チームの一意識別子。 グループの ID はチームと同じです。 このプロパティは読み取り専用であり、基本エンティティ型から継承されます。
classSettings teamClassSettings クラスの設定を構成します。 チームがクラスを表している場合のみ使用できます。
classification string 省略可能なラベル。 通常、チームのデータまたはビジネスの機密度を記述します。 テナントのディレクトリで事前に構成されているセットのいずれかに一致する必要があります。
createdDateTime dateTimeOffset チームが作成されたときのタイムスタンプ。
説明 string チームに関するオプションの説明。 最大文字数は 1024 文字です。
discoverySettings teamDiscoverySettings 他のユーザがチームの検出可能性を構成する設定。
displayName string チームの名前。
funSettings teamFunSettings チームで Giphy、ミーム、ステッカーの使用を構成するための設定。
guestSettings teamGuestSettings ゲストがチームでチャネルを作成、更新、削除できるかどうかを構成する設定。
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"},
  "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)"
}

関連コンテンツ