team リソースの種類team resource type

名前空間: microsoft.graphNamespace: microsoft.graph

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.

メソッドMethods

メソッドMethod 戻り値の型Return Type 説明Description
チームを作成するCreate team teamsAsyncOperationteamsAsyncOperation チームを新規に作成します。Create a team from scratch.
グループからチームを作成するCreate team from group 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.
メンバーを一覧表示するList members conversationMember コレクションconversationMember collection メンバーナビゲーションプロパティから conversationMembers を取得します。Get the conversationMembers from the members navigation property.
メンバーの追加Add members conversationMemberconversationMember 新しいメンバーを追加します。Add a new member.
メンバーの削除Remove members なしNone conversation オブジェクトを削除します。Delete a conversationMember object.
メンバーの役割を変更するChange member's role conversationMemberconversationMember メンバーを所有者または通常のメンバーに変更します。Change a member to an owner or back to a regular member.
チームをアーカイブするArchive team teamsAsyncOperationteamsAsyncOperation チームを読み取り専用状態にします。Put the team in a read-only state.
チームを展開するUnarchive team teamsAsyncOperationteamsAsyncOperation チームを読み取り/書き込み状態に復元します。Restore the team to a read-write state.
チームを複製するClone team teamsAsyncOperationteamsAsyncOperation チームとその関連グループをコピーします。Copy the team and its associated group.
チームを一覧表示するList your teams team コレクションteam collection メンバーであるチームの一覧を表示します。List the teams you are a member of.

プロパティProperties

プロパティProperty Type 説明Description
displayNamedisplayName stringstring チームの名前。The name of the team.
説明description stringstring チームに関するオプションの説明。An optional description for the team.
classificationclassification stringstring 省略可能なラベル。An optional label. 通常、チームのデータまたはビジネスの機密度を記述します。Typically describes the data or business sensitivity of the team. テナントのディレクトリで事前に構成されているセットのいずれかに一致する必要があります。Must match one of a pre-configured set in the tenant's directory.
specializationspecialization teamSpecializationteamSpecialization 省略可能。Optional. チームが特定のユース ケースを目的としているかどうかを示します。Indicates whether the team is intended for a particular use case. チーム専門分野ごとに、ユース ケースをターゲットとする一意の動作とエクスペリエンスにアクセスできます。Each team specialization has access to unique behaviors and experiences targeted to its use case.
visibilityvisibility teamVisibilityTypeteamVisibilityType グループとチームの可視性。The visibility of the group and team. 既定では Public です。Defaults to Public.
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.

リレーションシップRelationships

リレーションシップ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.
membersmembers conversationMember コレクションconversationMember collection チームのメンバーと所有者。Members and owners of the team.
操作operations teamsAsyncOperation コレクションteamsAsyncOperation collection このチームで実行済みまたは実行中の非同期操作です。The async operations that ran or are running on this team.
primaryChannelprimaryChannel channelchannel チームの全般チャネル。The general channel for the team.
scheduleschedule scheduleschedule このチームのシフトのスケジュール。The schedule of shifts for this team.
templatetemplate teamsTemplateteamsTemplate このチームの作成元テンプレート。The template this team was created from. 使用可能なテンプレートを参照してください。See available templates.

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