サイトのリソースの種類

[アーティクル]
04/01/2024

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

サイト リソースは、メタデータと SharePoint サイトのリレーションシップを提供します。

メソッド

メソッド	REST パス
ルートサイトを取得する	GET /sites/root
サイトを取得する	GET /sites/{site-id}
パスを使用してサイトを取得する	GET /sites/{hostname}:/{site-path}
グループのサイトを取得する	GET /groups/{group-id}/sites/root
分析を取得する	GET /sites/{site-id}/analytics
間隔によりアクティビティを取得する	GET /sites/{site-id}/getActivitiesByInterval
ページを一覧表示する	GET /sites/{site-id}/pages
ルートサイトを一覧表示する	GET /sites?filter=root ne null&select=siteCollection,webUrl
地域をまたいでサイトを一覧表示する	GET /site/getAllSites
サイトを検索する	GET /sites?search={query}
サイトをフォローする	POST /users/{user-id}/followedSites/add
サイトのフォローを取り消す	POST /users/{user-id}/followedSites/remove
フォローされたサイトを一覧表示する	GET /me/followedSites
アクセス許可を取得する	GET /sites/{site-id}/permissions/{permission-id}
アクセス許可を一覧表示する	GET /sites/{site-id}/permissions
アクセス許可を作成する	POST /sites/{site-id}/permissions
アクセス許可を削除する	DELETE /sites/{site-id}/permissions/{permission-id}
アクセス許可を更新する	PATCH /sites/{site-id}/permissions/{permission-id}
コンテンツタイプを一覧表示する	GET /sites/{site-id}/contentTypes
contentType を作成する	POST /sites/{site-id}/contentTypes
列を一覧表示する	GET /sites/{site-id}/columns
列を作成する	POST /sites/{site-id}/columns
リスト操作	GET /sites/{site-id}/operations
サイト設定を編集する	GET /sites/{site-id}/settings
Get delta	GET /sites/delta

プロパティ

プロパティ	型	説明
id	文字列	アイテムの一意識別子。読み取り専用です。
createdDateTime	DateTimeOffset	アイテムが作成された日時。読み取り専用です。
説明	string	サイトの説明テキスト。
eTag	string	アイテムの ETag。読み取り専用。
displayName	string	サイトの完全なタイトル。読み取り専用です。
lastModifiedDateTime	DateTimeOffset	アイテムが最後に変更された日時。読み取り専用です。
name	string	アイテムの名前/タイトル。
root	root	存在する場合は、サイトコレクション内のルートサイトを提供します。読み取り専用です。
settings	siteSettings	このサイトの設定。読み取り専用です。
sharepointIds	sharepointIds	SharePoint REST 互換性に役立つ識別子を返します。読み取り専用です。
siteCollection	siteCollection	サイトのサイトコレクションに関する詳細情報を提供します。ルートサイトにのみ使用できます。読み取り専用です。
webUrl	string (URL)	ブラウザーでアイテムを表示する URL。読み取り専用です。

ID プロパティ

サイトは、次の値の複合である一意な ID によって識別されます。

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

root 識別子は次に示すように、常にターゲットのルートサイトを参照します。

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

リレーションシップ

リレーションシップ	型	説明
分析	itemAnalytics	このサイトで行われたビューアクティビティに関する分析。
columns	columnDefinition コレクション	このサイトのすべてのリストで再利用可能なコラム定義のコレクションです。
contentTypes	contentType コレクション	このサイトに定義されたコンテンツタイプのコレクションです。
ドライブ	drive	このサイトの既定ドライブ (ドキュメントライブラリ)。
drives	drive コレクション	このサイトの下のドライブ (ドキュメントライブラリ) のコレクション。
externalColumns	columnDefinition コレクション	現在のサイトの親階層のサイトから参照されるサイトで使用できる列定義のコレクション。
アイテム	baseItem コレクション	このサイトに含まれるすべてのアイテムを処理するために使用されました。このコレクションは列挙できません。
lists	list コレクション	このサイトにあるリストのコレクションです。
操作	richLongRunningOperation コレクション	サイトの実行時間の長い操作のコレクション。
ページ	baseSitePage コレクション	このサイトの baseSitePages リスト内のページのコレクション。
アクセス許可	permission コレクション	サイトに関連付けられたアクセス許可。 Null 許容型。
recycleBin	recycleBin	このサイト内の recycleBinItem リソースのコレクションのコンテナー。
sites	site コレクション	このサイトの下のサブサイトのコレクション。
termStore	microsoft.graph.termStore.store	このサイトの下の termStore。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

サイト リソースは baseItem から派生しており、そのリソースからプロパティを継承しています。

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

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

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