サイトのリソースの種類
名前空間: microsoft.graph
重要
Microsoft Graph のバージョンの /beta API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 API が v1.0 で使用できるかどうかを確認するには、 バージョン セレクターを使用します。
サイト リソースは、メタデータと SharePoint サイトのリレーションシップを提供します。
メソッド
| Method | 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 /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 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| id | string | アイテムの一意識別子。読み取り専用です。 |
| 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:グループのチーム サイト。
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| analytics | itemAnalytics リソース | このサイトで行われたビュー アクティビティに関する分析。 |
| 列 | Collection(columnDefinition) | このサイトのすべてのリストで再利用可能なコラム定義のコレクションです。 |
| contentTypes | Collection(contentType) | このサイトに定義されたコンテンツ タイプのコレクションです。 |
| drive | [ドライブ][] | このサイトの既定ドライブ (ドキュメント ライブラリ)。 |
| ドライブ | Collection(drive) | このサイトの下のドライブ (ドキュメント ライブラリ) のコレクション。 |
| アイテム | Collection(baseItem) | このサイトに含まれるすべてのアイテムを処理するために使用されました。このコレクションを列挙することはできません。 |
| lists | Collection([list][]) | このサイトにあるリストのコレクションです。 |
| operations | richLongRunningOperation コレクション | サイトの実行時間の長い操作のコレクション。 |
| pages | Collection(sitePage) | このサイトにある SitePages リストのページのコレクション。 |
| アクセス許可 | コレクション ([アクセス許可][]) | サイトに関連付けられたアクセス許可。Null 許容型。 |
| sites | Collection([サイト][]) | このサイトの下のサブサイトのコレクション。 |
| termStore | microsoft.graph.termStore.store | このサイトの下の termStore。 |
| externalColumns | Collection(columnDefinition) | 現在のサイトの親階層にあるサイトから参照されるサイトで使用可能な列の定義のコレクション。 |
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"
}
フィードバック
フィードバックの送信と表示