team リソースの種類team resource type

Microsoft Teams のチームは、channel オブジェクトのコレクションです。A team in Microsoft Teams is a collection of channel objects. チャネルは 1 つのトピック、つまりチーム内でのディスカッションの論理的分離を表します。A channel represents a topic, and therefore a logical isolation of discussion, within a team.

各チームにはグループが関連付けられています。Every team is associated with a group. グループの ID はチームと同じです。たとえば、/groups/{id}/team は /teams/{id} と同じです。The group has the same ID as the team - for example, /groups/{id}/team is the same as /teams/{id}. チームのメンバーおよびグループの操作の詳細については、「Microsoft Graph REST API を使用して Microsoft Teams を操作する」を参照してください。For more information about working with groups and members in teams, see Use the Microsoft Graph REST API to work with Microsoft Teams.


メソッドMethod 戻り値の型Return Type 説明Description
チームを作成するCreate team teamteam 新しいチームを作成するか、既存のグループにチームを追加します。Create a new team, or add a team to an existing group.
チームを取得するGet team teamteam 指定したチームのプロパティとリレーションシップを取得します。Retrieve the properties and relationships of the specified team.
チームを更新するUpdate team teamteam 指定されたチームのプロパティを更新します。Update the properties of the specified team.
チームを削除するDelete team なしNone チームとその関連グループを削除します。Delete the team and its associated group.
チームを複製するClone team teamsAsyncOperationteamsAsyncOperation チームとその関連グループをコピーします。Copy the team and its associated group.
チームをアーカイブするArchive team teamsAsyncOperationteamsAsyncOperation チームを読み取り専用状態にします。Put the team in a read-only state.
チームを展開するUnarchive team teamsAsyncOperationteamsAsyncOperation チームを読み取り/書き込み状態に復元します。Restore the team to a read-write state.
チームを一覧表示するList your teams team コレクションteam collection メンバーであるチームの一覧を表示します。List the teams you are a member of.
すべてのチームのリストを作成するList all teams group コレクションgroup collection チームを持つすべてのグループを一覧表示します。List all groups that have teams.
組織に対してアプリを公開するPublish apps to your organization teamsAppteamsApp 所属組織のみに表示する Teams アプリを作成します。Create Teams apps visible only to your organization.
アプリをチームに追加するAdd app to team teamsAppInstallationteamsAppInstallation アプリをチームに追加 (インストール) します。Adds (installs) an app to a team.
チャネルにタブを追加するAdd tab to channel teamsTabteamsTab タブをチームのチャネルに追加 (インストール) します。Adds (installs) a tab to a team's channel.


プロパティProperty Type 説明Description
funSettingsfunSettings teamFunSettingsteamFunSettings チームでの Giphy、ミーム、およびステッカーの使用を構成する設定。Settings to configure use of Giphy, memes, and stickers in the team.
guestSettingsguestSettings teamGuestSettingsteamGuestSettings ゲストがチームでチャネルを作成、更新、削除できるかどうかを構成する設定。Settings to configure whether guests can create, update, or delete channels in the team.
InternalIdinternalId stringstring 監査ログまたは Office 365 マネージメント アクティビティ API など、いくつかの場所で使用されているチームの一意の ID。A unique ID for the team that has been used in a few places such as the audit log/Office 365 Management Activity API.
isArchivedisArchived BooleanBoolean このチームが読み取り専用モードかどうか。Whether this team is in read-only mode.
memberSettingsmemberSettings teamMemberSettingsteamMemberSettings メンバーが特定のアクション (チャネルの作成、ボットの追加など) をチーム内で実行できるかどうかを構成する設定。Settings to configure whether members can perform certain actions, for example, create channels and add bots, in the team.
messagingSettingsmessagingSettings teamMessagingSettingsteamMessagingSettings チームでメッセージとメンションを構成する設定。Settings to configure messaging and mentions in the team.
webUrlwebUrl string (読み取り専用)string (readonly) Microsoft Teams クライアントのチームに移動するハイパーリンク。A hyperlink that will go to the team in the Microsoft Teams client. これは、Microsoft Teams クライアントでチームを右クリックし、[Get link to team] を選択すると作成される URL です。This is the URL that you get when you right-click a team in the Microsoft Teams client and select Get link to team. この URL は不透明 blob として扱われる必要があり、また解析されません。This URL should be treated as an opaque blob, and not parsed.
classSettingsclassSettings teamClassSettingsteamClassSettings クラスの設定を構成します。Configure settings of a class. チームがクラスを表している場合のみ使用できます。Available only when the team represents a class.


リレーションシップRelationship Type 説明Description
channelschannels channel コレクションchannel collection チームに関連付けられているチャネルとメッセージのコレクション。The collection of channels & messages associated with the team.
installedAppsinstalledApps teamsAppInstallation コレクションteamsAppInstallation collection このチームにインストールされているアプリ。The apps installed in this team.

JSON 表記JSON representation

リソースの JSON 表記を次に示します。The following is a JSON representation of the resource.

注: チームがタイプ クラスである場合は、classSettings プロパティがチームに適用されます。Note: If the team is of type class, a classSettings property is applied on the team.

  "guestSettings": {"@odata.type": "microsoft.graph.teamGuestSettings"},
  "memberSettings": {"@odata.type": "microsoft.graph.teamMemberSettings"},
  "messagingSettings": {"@odata.type": "microsoft.graph.teamMessagingSettings"},
  "funSettings": {"@odata.type": "microsoft.graph.teamFunSettings"},
  "internalId": "string",
  "isArchived": false,
  "webUrl": "string (URL)",
  "classSettings": {"@odata.type": "microsoft.graph.teamClassSettings"}

関連項目See Also