サイトのリソースの種類site resource type

重要

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 サイトのメタデータとリレーションシップを提供します。The site resource provides metadata and relationships for a SharePoint site.

メソッドMethods

MethodMethod REST パスREST Path
ルート サイトを取得するGet root site GET /sites/rootGET /sites/root
サイトを取得するGet site GET /sites/{site-id}GET /sites/{site-id}
パスを使用してサイトを取得するGet site by path GET /sites/{hostname}:/{site-path}GET /sites/{hostname}:/{site-path}
グループのサイトを取得するGet site for a group GET /groups/{group-id}/sites/rootGET /groups/{group-id}/sites/root
分析を取得するGet analytics GET /sites/{site-id}/analyticsGET /sites/{site-id}/analytics
間隔によりアクティビティを取得するGet activities by interval GET /sites/{site-id}/getActivitiesByIntervalGET /sites/{site-id}/getActivitiesByInterval
ページを一覧表示するList pages GET /sites/{site-id}/pagesGET /sites/{site-id}/pages
ルート サイトを一覧表示するList root sites GET /sites?filter=root ne null&select=siteCollection,webUrlGET /sites?filter=root ne null&select=siteCollection,webUrl
サイトを検索するSearch for sites GET /sites?search={query}GET /sites?search={query}
サイトをフォローするFollow Site POST /users/{user-id}/followedSites/addPOST /users/{user-id}/followedSites/add
サイトのフォローを取り消すUnfollow Site POST /users/{user-id}/followedSites/removePOST /users/{user-id}/followedSites/remove

プロパティProperties

プロパティ名Property name 種類Type 説明Description
idid 文字列string アイテムの一意識別子The unique identifier of the item. 読み取り専用です。Read-only.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset アイテムが作成された日時。読み取り専用です。The date and time the item was created. Read-only.
説明description stringstring サイトの説明テキスト。The descriptive text for the site.
eTageTag stringstring アイテムの ETag。読み取り専用です。ETag for the item. Read-only.
displayNamedisplayName stringstring サイトの完全なタイトル。読み取り専用です。The full title for the site. Read-only.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset アイテムが最後に変更された日時。読み取り専用です。The date and time the item was last modified. Read-only.
namename stringstring アイテムの名前/タイトル。The name / title of the item.
rootroot rootroot 存在する場合は、これがサイト コレクションのルート サイトであることを示します。読み取り専用です。If present, indicates that this is the root site in the site collection. Read-only.
sharepointIdssharepointIds sharepointIdssharepointIds SharePoint REST 互換性に役立つ識別子を返します。読み取り専用です。Returns identifiers useful for SharePoint REST compatibility. Read-only.
siteCollectionsiteCollection siteCollectionsiteCollection サイトのサイト コレクションに関する詳細情報を提供します。ルート サイトにのみ使用できます。読み取り専用です。Provides details about the site's site collection. Available only on the root site. Read-only.
webUrlwebUrl string (URL)string (url) ブラウザーでアイテムを表示する URL。読み取り専用です。URL that displays the item in the browser. Read-only.

ID プロパティid property

サイトは、次の値の複合である一意な ID によって識別されます。A site is addressed by a unique identifier which is a composite ID of the following values:

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

root 識別子は次に示すように、常にターゲットのルート サイトを参照します。There is also a reserved site identifier, root, which always references the root site for a given target, as follows:

  • /sites/root:テナントのルート サイト。/sites/root: The tenant root site.
  • /groups/{group-id}/sites/root:グループのチーム サイト。/groups/{group-id}/sites/root: The group's team site.

リレーションシップRelationships

リレーションシップ名Relationship name 種類Type 説明Description
analyticsanalytics itemAnalytics リソースitemAnalytics resource このサイトで行われたビュー アクティビティに関する分析。Analytics about the view activities that took place in this site.
columns Collection(columnDefinition)Collection(columnDefinition) このサイトのすべてのリストで再利用可能なコラム定義のコレクションです。The collection of column definitions reusable across lists under this site.
contentTypescontentTypes Collection(contentType)Collection(contentType) このサイトに定義されたコンテンツ タイプのコレクションです。The collection of content types defined for this site.
drivedrive [ドライブ][]drive このサイトの既定ドライブ (ドキュメント ライブラリ)。The default drive (document library) for this site.
ドライブdrives Collection(drive)Collection(drive) このサイトの下のドライブ (ドキュメント ライブラリ) のコレクション。The collection of drives (document libraries) under this site.
アイテムitems Collection(baseItem)Collection(baseItem) このサイトに含まれるすべてのアイテムを処理するために使用されました。このコレクションを列挙することはできません。Used to address any item contained in this site. This collection cannot be enumerated.
listslists Collection(list)Collection(list) このサイトにあるリストのコレクションです。The collection of lists under this site.
pagespages Collection(sitePage)Collection(sitePage) このサイトにある SitePages リストのページのコレクション。The collection of pages in the SitePages list in this site.
sitessites Collection([サイト][])Collection(site) このサイトの下のサブサイトのコレクション。The collection of the sub-sites under this site.

JSON 表記JSON representation

以下は、サイト リソースの JSON 表記です。Here is a JSON representation of a site resource.

サイト リソースは baseItem から派生しており、そのリソースからプロパティを継承しています。The site resource is derived from baseItem and inherits properties from that resource.

{
  "id": "string",
  "root": { "@odata.type": "microsoft.graph.root" },
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
  "siteCollection": {"@odata.type": "microsoft.graph.siteCollection"},
  "displayName": "string",

  /* relationships */
  "analytics": { "@odata.type": "microsoft.graph.itemAnalytics" },
  "contentTypes": [ { "@odata.type": "microsoft.graph.contentType" }],
  "drive": { "@odata.type": "microsoft.graph.drive" },
  "drives": [ { "@odata.type": "microsoft.graph.drive" }],
  "items": [ { "@odata.type": "microsoft.graph.baseItem" }],
  "lists": [ { "@odata.type": "microsoft.graph.list" }],
  "sites": [ { "@odata.type": "microsoft.graph.site"} ],
  "columns": [ { "@odata.type": "microsoft.graph.columnDefinition" }],

  /* inherited from baseItem */
  "name": "string",
  "createdDateTime": "datetime",
  "description": "string",
  "eTag": "string",
  "lastModifiedDateTime": "datetime",
  "webUrl": "url"
}