パスを使用したサイト リソースの取得

名前空間: microsoft.graph

サイト リソースのプロパティとリレーションシップを取得します。 サイト リソースは、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 要求

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

要求ヘッダー

名前	説明
Authorization	ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。

例

要求

相対パスを使用してルートの SharePoint サイトにアクセスするには、次のようにします。

GET https://graph.microsoft.com/v1.0/sites/{hostname}:/{relative-path}

応答

このメソッドは、一意の識別子によって参照されるサイトのサイト リソースを返します。

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",
  "isPersonalSite": false,
  "name": "1drvteam",
  "createdDateTime": "2017-05-09T20:56:00Z",
  "lastModifiedDateTime": "2017-05-09T20:56:01Z",
  "webUrl": "https://contoso.sharepoint.com/teams/1drvteam"
}