サイト リソースを取得するGet a site resource

重要

Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでは、これらの API の使用はサポートされていません。Use of these APIs in production applications is not supported.

サイト リソースのプロパティとリレーションシップを取得します。サイト リソースは、SharePoint のチーム サイトを表します。Retrieve properties and relationships for a site resource. A site resource represents a team site in SharePoint.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

アクセス許可の種類Permission type アクセス許可 (特権の小さいものから大きいものへ)Permissions (from least to most privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) Sites.Read.All、Sites.ReadWrite.AllSites.Read.All, Sites.ReadWrite.All
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) サポートされていません。Not supported.
アプリケーションApplication Sites.Read.All、Sites.ReadWrite.AllSites.Read.All, Sites.ReadWrite.All

テナントのルート サイトを取得するGet the tenant's root site

テナント内のルートの SharePoint サイトにアクセスするには次のようにします。To access the root SharePoint site within a tenant:

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

サーバーの相対 URL でサイトにアクセスするAccess a site by server-relative URL

サイト リソースのサーバーの相対 URL がある場合、次のように要求を構築することができます。If you have the server-relative URL for a site resource, you can construct a request as follows:

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

グループのチーム サイトにアクセスするAccess a group team site

グループのチーム サイトにアクセスするには次のようにします。To access the team site for a group:

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

Example

要求Request

GET /sites/{site-id}

応答Response

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

{
  "id": "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE",
  "owner": {
    "user": {
      "displayName": "Daron Spektor",
      "id": "5280E7FE-DC7A-4486-9490-E790D81DFEB3"
    }
  },
  "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"
}