このドキュメントでは、Google Sites Data API で使用される raw プロトコル（XML と HTTP）に関する詳細なリファレンス ドキュメントを提供します。
このドキュメントには、プログラミング言語のクライアント ライブラリに関する情報は記載されていません。クライアント ライブラリのリファレンス情報については、デベロッパー ガイドのプログラミング言語固有のセクションにあるリンクをご覧ください。
オーディエンス
このドキュメントは、Google サイトとやり取りできるクライアント アプリケーションを作成するプログラマーを対象としています。
これはリファレンス ドキュメントであり、プロトコル ガイドで説明されているコンセプトと、Google Data APIs プロトコルの基本的な考え方を理解していることを前提としています。
Google サイトのフィードの種類
Google Sites Data API には、次のタイプのフィードが用意されています。
アクティビティ フィード
アクティビティ フィードは、サイト内のすべてのアクティビティの説明を含むフィードです。
特定のドメイン内のサイトを示す、このフィードの GET URI は次のとおりです。
https://sites.google.com/feeds/activity/domainName/siteName/[activityEntryID]
domainName は「site」または G Suite ドメインです。
siteName は、サイトのリンク先ページ URL（http://sites.google.com/a/domainName/siteName/）に表示されるサイト名です。
このフィードに対するリクエストはすべて認証する必要があります。
サポートされているリクエスト タイプ: GET
コンテンツ フィード
コンテンツ フィードは、編集可能な現在のサイト コンテンツを含むフィードです。
特定のドメイン内のサイトを示す、このフィードの GET URI は次のとおりです。
https://sites.google.com/feeds/content/domainName/siteName/[contentEntryID]
domainName は「site」または G Suite ドメインです。
siteName は、サイトのランディング ページ URL（http://sites.google.com/a/domainName/siteName）に表示されるサイト名です。
このフィードのリクエストには、サイトの（公開済み）設定に応じて認証が必要な場合があります。
サポートされているリクエスト タイプ: GET、POST、PUT、DELETE
標準の Data API クエリ パラメータに加えて、Sites Data API では、Content フィードを使用して GET リクエストを発行する次のオプションのパラメータを使用できます。
| パラメータ | 説明 | タイプ | メモ |
|---|---|---|---|
ancestor |
指定された祖先を持つエントリのみをリクエストします。 | 文字列 | 目的の祖先エントリの ID を指定します。例: 0123456789。指定された祖先を親、親の親（以下同様）として持つすべてのエントリを返します。 |
include-deleted |
削除されたエントリを含めるかどうかを指定します。 | ブール値 | 指定可能な値は true または false です。デフォルトは false です。 |
include-draft |
下書きのエントリを含めるかどうかを指定します。 | ブール値 | 指定可能な値は true または false です。デフォルトは false です。下書きを表示するには、下書きのオーナーまたは作成者である必要があります。 |
kind |
返されるコンテンツ エントリの種類を指定します。これらは、Google サイト内のページの種類に従います。 | 文字列のカンマ区切りリスト | 有効な値は、announcement、announcementspage、attachment、comment、filecabinet、listitem、listpage、webpage、webattachment、template です。 |
parent |
指定された親を持つエントリのみをリクエストします。 | 文字列 | 親エントリの ID を指定します。例: 0123456789。 |
path |
特定のページ階層内のコンテンツをリクエストする | 文字列 | コンテンツを取得するサイト内のサブページのパス。例: path=/path/to/page。 |
リビジョン フィード
変更履歴フィードは、サイト コンテンツの変更履歴を含むフィードです。
特定のドメイン内のサイトのこのフィードの GET URI は次のとおりです。
https://sites.google.com/feeds/revision/domainName/siteName/contentEntryID/[revisionEntryID]
domainName は「site」または G Suite ドメインです。
siteName は、サイトのリンク先ページ URL（http://sites.google.com/a/domainName/siteName）に表示されるサイト名です。
このフィードへのすべてのリクエストは認証する必要があります。
サポートされているリクエスト タイプ: GET
サイトフィード
サイトフィードを使用すると、ユーザーが所有する Google サイト、または閲覧権限のある Google サイトを一覧表示できます。また、新しいサイトの作成、サイトのコピー、既存のサイトの名前の変更にも使用できます。
サイトのリスティングのフィード URI は次のとおりです。
https://sites.google.com/feeds/site/domainName/[siteName]
domainName は「site」または G Suite ドメインです。
このフィードへのすべてのリクエストは認証する必要があります。
サポートされているリクエスト タイプ: GET、POST、PUT
サイトフィードは、リスティング サイトの GET リクエストを発行する際に、次の（省略可能な）パラメータをサポートしています。
| パラメータ | 説明 | タイプ | メモ |
|---|---|---|---|
include-all-sites |
G Suite ドメイン内のユーザーが少なくとも表示できるすべてのサイトを一覧表示します。 | ブール値 | このパラメータは、G Suite ドメインのサイトを一覧表示する場合にのみ適用されます。指定可能な値は true または false です。デフォルトは false です。 |
with-mappings |
サイトエントリにウェブアドレスのマッピングを含めます。 | ブール値 | 指定可能な値は true または false です。デフォルトは false です。 |
ACL フィード
ACL フィードを使用すると、Google サイトの共有権限（ACL）を一覧表示したり、変更したりできます。
サイトのリスティングのフィード URI は次のとおりです。
https://sites.google.com/feeds/acl/site/domainName/siteName/[aclEntryID]
domainName は「site」または G Suite ドメインです。
このフィードへのすべてのリクエストは認証する必要があります。
サポートされているリクエスト タイプ: GET、POST、PUT、DELETE
Google サイトのクエリ パラメータのリファレンス
Google Data API プロトコルでサポートされているクエリ パラメータ:
max-resultspublished-max（コンテンツ フィードのみ）published-min（コンテンツ フィードのみ）start-indexupdated-maxupdated-minq（全文クエリ）
各フィードに固有のパラメータの一覧については、上記の各フィードをご覧ください。