サイトを列挙する

指定されたフィルター条件とクエリ オプションに一致する組織内の使用可能な サイト を一覧表示します。

現在サポートされているクエリ オプションは次のとおりです。

Filter ステートメント	Select ステートメント	説明
siteCollection/root ne null	siteCollection,webUrl	組織内のすべてのルート レベルのサイト コレクションを一覧表示します。 各地域のホーム サイトを検出するのに役立ちます。

さらに、'/sites' コレクションに対する 検索 クエリを使用して、特定のキーワードに一致するサイトを検索できます。

アクセス許可

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

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

HTTP 要求

GET /sites?filter=siteCollection/root ne null

例

要求

GET /sites?select=siteCollection,webUrl&filter=siteCollection/root%20ne%20null

応答

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

{
  "value": [
    {
      "id": "contoso.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,712a596e-90a1-49e3-9b48-bfa80bee8740",
      "name": "Contoso USA",
      "root": { },
      "siteCollection": {
        "hostname": "contoso.sharepoint.com",
        "dataLocationCode": "NAM",
        "root": { }
      },
      "webUrl": "https://contoso.sharepoint.com"
    },
    {
      "id": "contoso-jpn.sharepoint.com,da60e844-ba1d-49bc-b4d4-d5e36bae9019,0271110f-634f-4300-a841-3a8a2e851851",
      "name": "Contoso Japan",
      "root": { },
      "siteCollection": {
        "hostname": "contoso-jp.sharepoint.com",
        "dataLocationCode": "JPN",
        "root": { }
      },
      "webUrl": "https://contoso-jp.sharepoint.com"
    }
  ]
}