team リソースの種類team resource type


Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。Use of these APIs in production applications is not supported.

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 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.
チームを複製する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.
チームの写真を取得するGet team photo バイナリ型データBinary data チームの写真 (画像) を取得します。Get the photo (picture) for a team.
チームの写真を更新するUpdate team photo なしNone チームの写真 (画像) を更新します。Update the photo (picture) for a team.
組織に対してアプリを公開する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.
チャネル メッセージを一覧表示するList channel messages chatMessagechatMessage チャネルのメッセージを取得するGet messages in a channel
チャネルでの chatMessage の作成Create chatMessage in a channel chatMessagechatMessage メッセージをチャネルに送信します。Send a message to a channel.
チャネルでの chatMessage 返信の作成Create chatMessage reply in a channel chatMessagechatMessage チャネル内のメッセージに返信します。Reply to a message in a channel.


プロパティ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 a 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.
discoverySettingsdiscoverySettings teamDiscoverySettingsteamDiscoverySettings 他のユーザがチームの検出可能性を構成する設定。Settings to configure team discoverability by others.
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.
ownersowners useruser このチームの所有者の一覧。The list of this team's owners. 現時点では、アプリケーションのアクセス許可を使用してチームを作成するときに、必ず 1 つの所有者を指定してください。Currently, when creating a team using application permissions, exactly one owner must be specified. ユーザー委任アクセス許可を使用するときには、所有者を指定できません (現在のユーザーが所有者になります)。When using user delegated permissions, no owner can be specified (the current user is the owner). 所有者は、UPN ではなくオブジェクト ID (GUID) として指定する必要があります。Owner must be specified as an object ID (GUID), not a UPN.
operationsoperations 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"},
  "discoverySettings": {"@odata.type": "microsoft.graph.teamDiscoverySettings"},
  "internalId": "string",
  "isArchived": false,
  "webUrl": "string (URL)",
  "displayName": "string",
  "description": "string",
  "classification": "string",
  "specialization": "string",
  "visibility": "string",
  "classSettings": {"@odata.type": "microsoft.graph.teamClassSettings"}

関連項目See Also