次の方法で共有

サイト リソースを取得する

  • [アーティクル]

サイト リソースのプロパティとリレーションシップを取得します。 サイト リソースは、SharePoint のチーム サイトを表します。

サイトは、以下の値の複合 ID である、一意識別子にアドレス指定されます。

  • サイト コレクションのホスト名 (contoso.sharepoint.com)
  • サイト コレクションの一意 ID (GUID)
  • サイトの一意 ID (GUID)

予約済みのサイト識別子 root もあります。これは次に示すように、常にターゲットのルート サイトを参照します。

  • /sites/root:テナントのルート サイト。
  • /groups/{group-id}/sites/root:グループのチーム サイト。

さらに、特定の地理的インスタンス (マルチ geo テナントの場合) のルート サイトには、次のように geography の dataLocationCode を使用してアクセスできます。

  • /sites/NAM: テナントの北米インスタンスのルート サイト
  • /sites/EUR: テナントのヨーロッパインスタンスのルート サイト

アクセス許可

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

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

テナントのルート サイトを取得する

テナント内のルートの SharePoint サイトにアクセスするには次のようにします。

GET /sites/root
GET /sites/contoso.sharepoint.com
GET /sites/JPN

サーバーの相対 URL でサイトにアクセスする

サイト リソースのサーバーの相対 URL がある場合、次のように要求を構築することができます。

GET /sites/{hostname}:/{server-relative-path}

グループのチーム サイトにアクセスする

グループのチーム サイトにアクセスするには次のようにします。

GET /groups/{group-id}/sites/root

例

要求

GET /sites/{site-id}

応答

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

{
  "id": "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE",
  "displayName": "OneDrive Team Site",
  "name": "1drvteam",
  "createdDateTime": "2017-05-09T20:56:00Z",
  "lastModifiedDateTime": "2017-05-09T20:56:01Z",
  "webUrl": "https://contoso.sharepoint.com/teams/1drvteam"
}