Reference Guide

This document provides detailed reference documentation for the raw protocol (XML and HTTP) for the Google Sites Data API.

This document doesn't contain information about the programming-language client libraries. For client-library reference information, see the links from the programming-language-specific sections of the developer's guide.

Audience

This document is intended for programmers who want to write client applications that can interact with Google Sites.

It's a reference document; it assumes that you understand the concepts presented in the protocol guide, and the general ideas behind the Google Data APIs protocol.

Google Sites feed types

The Google Sites Data API provides the following types of feeds:

Activity feed

The Activity feed is a feed containing descriptions of all activites within a site.

This feed's GET URI for a site within a particular domain is:

https://sites.google.com/feeds/activity/domainName/siteName/[activityEntryID]

domainName is either "site", or a G Suite domain.

siteName is the site name as it appears in the site's landing page URL: http://sites.google.com/a/domainName/siteName/.

All requests to this feed must be authenticated.

Supported request types: GET

Content feed

The Content feed is a feed containing the current, editable site content.

This feed's GET URI for a site within a particular domain is:

https://sites.google.com/feeds/content/domainName/siteName/[contentEntryID]

domainName is either "site", or a G Suite domain.

siteName is the site name as it appears in the site's landing page URL: http://sites.google.com/a/domainName/siteName.

Requests to this feed may or may not require authentication, depending on the Site's (published) settings.

Supported request types: GET, POST, PUT, DELETE

In addition to the standard Data API query parameters, the Sites Data API allows the following optional parameters issuing GET request using the Content feed:

Parameter Description Type Notes
ancestor Requests only entries that have the specified ancestor. string Provide the ID of the desired ancestor entry. For example: 0123456789. Returns all entries that have the specified ancestor as a parent, a parent's parent, and so on.
include-deleted Specifies whether to include deleted entries. boolean Possible values are true or false. Default is false.
include-draft Specifies whether to include draft entries. boolean Possible values are true or false. Default is false. You need to be the owner or author of the draft to view it.
kind Specifies the kind(s) of content entries to return. These follow the type of page within Google Sites. comma separated list of strings Possible values are announcement, announcementspage, attachment, comment, filecabinet, listitem, listpage, webpage, webattachment, template.
parent Requests only entries that have the specified parent. string Provide the ID of the parent entry. For example: 0123456789.
path Requests content under a certain page hierarchy string The path to a subpage within a Site to fetch content for. For example: path=/path/to/page.

Revision feed

The Revision feed is a feed containing historical revisions of site content.

This feed's GET URI for a site within a particular domain is:

https://sites.google.com/feeds/revision/domainName/siteName/contentEntryID/[revisionEntryID]

domainName is either "site", or a G Suite domain.

siteName is the site name as it appears in the site's landing page URL: http://sites.google.com/a/domainName/siteName.

All requests to this feed must be authenticated.

Supported request types: GET

Site feed

The site feed can be used to list the Google Sites a user owns or has viewing permissions for. It can also be used to create new sites, copy a site, or modify the name of an existing site.

The feed URI for the Sites listing is:

https://sites.google.com/feeds/site/domainName/[siteName]

domainName is either "site", or a G Suite domain.

All requests to this feed must be authenticated.

Supported request types: GET, POST, PUT

The site feed supports the following (optional) parameters when issuing a GET request for listing sites:

Parameter Description Type Notes
include-all-sites List all sites that can be at least viewed by the user in the G Suite domain. boolean This parameter is only applicable when listing sites for a G Suite domain. Possible values are true or false. Default is false.
with-mappings Includes the web address mappings in a site entry. boolean Possible values are true or false. Default is false.

ACL feed

The ACL feed can be used to list and/or modify the sharing permissions (ACLs) of a Google Site.

The feed URI for the Sites listing is:

https://sites.google.com/feeds/acl/site/domainName/siteName/[aclEntryID]

domainName is either "site", or a G Suite domain.

All requests to this feed must be authenticated.

Supported request types: GET, POST, PUT, DELETE

Google Sites query parameters reference

Supported query parameters from the Google Data API protocol:

  • max-results
  • published-max (only content feed)
  • published-min (only content feed)
  • start-index
  • updated-max
  • updated-min
  • q (full text-queries)

See each feed above for a list of parameters specific to that feed.

Back to top