フィードバック 編集

チームの一覧表示

  • [アーティクル]

名前空間: microsoft.graph

重要

Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。

組織内のすべての チーム を一覧表示します。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

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

HTTP 要求

GET /teams

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

このメソッドは、応答のカスタマイズに役立つ $filter, $select, $top, $skiptoken, $count OData クエリ パラメーターをサポートします。

要求ヘッダー

ヘッダー 値
Authorization ベアラー {token}。必須。
承諾 application/json

要求本文

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

応答

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

注意

現在、この API 呼び出しは、チームの ID、displayName、description プロパティのみを返します。 すべてのプロパティを取得するには、 Get team 操作を使用します。

例

例 1: チームのリストを取得する

要求

要求の例を次に示します。

GET https://graph.microsoft.com/beta/teams

応答

応答の例を次に示します。

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

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"
    },
    {
      "id": "890972b0cce-e65d-44ce-9a49-568hhsd7n",
      "displayName": "Contoso General Team",
      "description": "This is a general Contoso team"
    },
    ,
    {
      "id": "98678abcce0-e65d-44ce-9a49-9980bj8kl0e",
      "displayName": "Contoso API Team",
      "description": "This is Contoso API team"
    }
  ]
}

例 2: $filterと $topを使用して、表示名が 'A' で始まる 2 つのチームを取得する

要求

要求の例を次に示します。

GET https://graph.microsoft.com/beta/teams?$filter=startswith(displayName, 'A')&$top=2

応答

応答の例を次に示します。

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

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

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

例 3: displayName $filterチームの id と$select説明を取得するには、"Contoso チーム" を使用します。

要求

要求の例を次に示します。

GET https://graph.microsoft.com/beta/teams?$filter=displayName eq 'A Contoso Team'&$select=id,description

応答

応答の例を次に示します。

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

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

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

関連項目