パスを使用したサイト リソースの取得
サイト リソースのプロパティとリレーションシップを取得します。 サイト リソースは、SharePoint のチーム サイトを表します。
ID を使用したサイトの取得のほかに、サーバーの相対 URL パスに基づいてサイトを取得できます。
- サイト コレクションのホスト名 (contoso.sharepoint.com)
- サーバーのホスト名を基準にしたサイトのパス。
予約済みのサイト識別子 root
もあり、これは次のように、ターゲットのルート サイトを常に参照します。
/sites/root
:テナントのルート サイト。/groups/{group-id}/sites/root
:グループのチーム サイト。
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
---|---|
委任 (職場または学校のアカウント) | Sites.Read.All、Sites.ReadWrite.All |
委任 (個人用 Microsoft アカウント) | サポートされていません。 |
アプリケーション | Sites.Read.All、Sites.ReadWrite.All |
HTTP 要求
相対パスを使用してルートの SharePoint サイトにアクセスするには、次のようにします。
GET /sites/{hostname}:/{relative-path}
HTTP 応答
このメソッドは、一意の識別子によって参照されるサイトのサイト リソースを返します。
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"
}