英語で読む

次の方法で共有


joinedTeams を一覧表示する

名前空間: microsoft.graph

ユーザーがダイレクト メンバーになっている Microsoft Teams のチームを取得します。

メモ: この API は、ユーザーが直接メンバーである共有チャネルのホスト チームを返しません。 関連付けられた Teams API の一覧表示を使用して、ユーザーがアクセスできる共有チャネルのホスト チームを取得します。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「 アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、 アクセス許可のリファレンスを参照してください

アクセス許可の種類 最小特権アクセス許可 特権の高いアクセス許可
委任 (職場または学校アカウント) Team.ReadBasic.All Directory.Read.All、Directory.ReadWrite.All、TeamSettings.Read.All、TeamSettings.ReadWrite.All、User.Read.All、User.ReadWrite.All
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション Team.ReadBasic.All TeamSettings.Read.All、TeamSettings.ReadWrite.All

注意

Directory.Read.All および Directory.ReadWrite.All のアクセス許可は、下位互換性のためにのみサポートされます。 前の表に記載されている別のアクセス許可を使用するようにソリューションを更新し、今後これらのアクセス許可を使用しないようにすることをお勧めします。

HTTP 要求

GET /me/joinedTeams
GET /users/{id | user-principal-name}/joinedTeams

オプションのクエリ パラメーター

このメソッドは現在、応答をカスタマイズするための OData クエリ パラメーター をサポートしていません。

要求ヘッダー

ヘッダー
Authorization ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。
承諾 application/json

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、このメソッドは 200 OK 応答コードと、応答本文で team オブジェクトのコレクションを返します。

注意

この API には、チームIDdisplayName説明プロパティのみが返される既知の問題があります。すべてのプロパティを取得するには、チームの取得操作を使用します。

要求

次の例は要求を示しています。

GET https://graph.microsoft.com/v1.0/me/joinedTeams

応答

次の例は応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": [
    {
      "id": "172b0cce-e65d-44ce-9a49-91d9f2e8493a",
      "displayName": "Contoso Team",
      "description": "This is a Contoso team, used to showcase the range of properties supported by this API"
    }
  ]
}