Dieses Dokument enthält eine ausführliche Referenzdokumentation für das Rohprotokoll (XML und HTTP) der Google Sites Data API.
Dieses Dokument enthält keine Informationen zu den Clientbibliotheken der Programmiersprachen. Referenzinformationen zu Clientbibliotheken finden Sie in den Links in den programmsprachenspezifischen Abschnitten des Entwicklerhandbuchs.
Zielgruppe
Dieses Dokument richtet sich an Programmierer, die Clientanwendungen schreiben möchten, die mit Google Sites interagieren können.
Es handelt sich um ein Referenzdokument. Es wird davon ausgegangen, dass Sie die im Protokollleitfaden vorgestellten Konzepte und die allgemeinen Ideen hinter dem Google Data APIs-Protokoll verstehen.
Feedtypen für Google Sites
Die Google Sites Data API bietet die folgenden Feedtypen:
Aktivitätsfeed
Der Aktivitätsfeed ist ein Feed mit Beschreibungen aller Aktivitäten auf einer Website.
Die GET-URI dieses Feeds für eine Website innerhalb einer bestimmten Domain lautet:
https://sites.google.com/feeds/activity/domainName/siteName/[activityEntryID]
domainName ist entweder „website“ oder eine G Suite-Domain.
siteName ist der Name der Website, wie er in der Landingpage-URL der Website erscheint: http://sites.google.com/a/domainName/siteName/.
Alle Anfragen an diesen Feed müssen authentifiziert werden.
Unterstützte Anfragetypen: GET
Inhaltsfeed
Der Content-Feed enthält die aktuellen, bearbeitbaren Websiteinhalte.
Der GET-URI dieses Feeds für eine Website innerhalb einer bestimmten Domain lautet:
https://sites.google.com/feeds/content/domainName/siteName/[contentEntryID]
domainName ist entweder „Website“ oder eine G Suite-Domain.
siteName ist der Name der Website, wie er in der Landingpage-URL der Website erscheint: http://sites.google.com/a/domainName/siteName.
Für Anfragen an diesen Feed ist möglicherweise eine Authentifizierung erforderlich. Dies ist abhängig von den (veröffentlichten) Einstellungen der Website.
Unterstützte Anfragetypen: GET, POST, PUT, DELETE
Zusätzlich zu den Standardabfrageparametern der Data API können Sie mit der Sites Data API die folgenden optionalen Parameter verwenden, um eine GET-Anfrage mit dem Content-Feed zu senden:
| Parameter | Beschreibung | Typ | Hinweise |
|---|---|---|---|
ancestor |
Fordert nur Einträge mit dem angegebenen Ancestor an. | String | Geben Sie die ID des gewünschten übergeordneten Eintrags an. Beispiel: 0123456789. Gibt alle Einträge zurück, die den angegebenen Ancestor als übergeordnetes Element haben, das übergeordnete Element des übergeordneten Elements usw. |
include-deleted |
Gibt an, ob gelöschte Einträge eingeschlossen werden sollen. | boolean | Mögliche Werte sind true und false. Der Standardwert ist false. |
include-draft |
Gibt an, ob Entwurfseinträge eingeschlossen werden sollen. | boolean | Mögliche Werte sind true und false. Der Standardwert ist false. Sie müssen Inhaber oder Autor des Entwurfs sein, um ihn aufzurufen. |
kind |
Gibt an, welche Art von Inhaltseinträgen zurückgegeben werden soll. Sie richten sich nach dem Seitentyp in Google Sites. | Komma getrennte Liste von Strings | Mögliche Werte sind announcement, announcementspage, attachment,
comment, filecabinet, listitem, listpage, webpage, webattachment,
template. |
parent |
Es werden nur Einträge angefordert, die das angegebene übergeordnete Element haben. | String | Geben Sie die ID des übergeordneten Eintrags an. Beispiel: 0123456789. |
path |
Fordert Inhalte unter einer bestimmten Seitenhierarchie an | String | Der Pfad zu einer Unterseite innerhalb einer Website, für die Inhalte abgerufen werden sollen. Beispiel: path=/path/to/page. |
Überarbeitungsfeed
Der Revisionfeed ist ein Feed mit früheren Versionen von Websitecontent.
Die GET-URI dieses Feeds für eine Website innerhalb einer bestimmten Domain lautet:
https://sites.google.com/feeds/revision/domainName/siteName/contentEntryID/[revisionEntryID]
domainName ist entweder „Website“ oder eine G Suite-Domain.
siteName ist der Name der Website, wie er in der Landingpage-URL der Website angezeigt wird: http://sites.google.com/a/domainName/siteName.
Alle Anfragen an diesen Feed müssen authentifiziert werden.
Unterstützte Anfragetypen: GET
Website-Feed
Im Websitefeed können die Google Sites aufgeführt werden, deren Inhaber ein Nutzer ist oder für die er Leseberechtigungen hat. Sie kann auch verwendet werden, um neue Websites zu erstellen, Websites zu kopieren oder den Namen einer vorhandenen Website zu ändern.
Die Feed-URI für den Eintrag „Websites“ lautet:
https://sites.google.com/feeds/site/domainName/[siteName]
domainName ist entweder „Website“ oder eine G Suite-Domain.
Alle Anfragen an diesen Feed müssen authentifiziert werden.
Unterstützte Anfragetypen: GET, POST, PUT
Der Website-Feed unterstützt die folgenden (optionalen) Parameter bei einer GET-Anfrage zum Auflisten von Websites:
| Parameter | Beschreibung | Typ | Hinweise |
|---|---|---|---|
include-all-sites |
Liste aller Websites, die der Nutzer in der G Suite-Domain mindestens aufrufen kann. | boolean | Dieser Parameter gilt nur, wenn Websites für eine G Suite-Domain aufgeführt werden. Mögliche Werte sind true und false. Der Standardwert ist false. |
with-mappings |
Enthält die Zuordnungen von Webadressen in einem Websiteeintrag. | boolean | Mögliche Werte sind true und false. Der Standardwert ist false. |
ACL-Feed
Mit dem ACL-Feed können Sie die Freigabeberechtigungen (ACLs) einer Google-Website auflisten und/oder ändern.
Die Feed-URI für den Eintrag „Websites“ lautet:
https://sites.google.com/feeds/acl/site/domainName/siteName/[aclEntryID]
domainName ist entweder „Website“ oder eine G Suite-Domain.
Alle Anfragen an diesen Feed müssen authentifiziert werden.
Unterstützte Anfragetypen: GET, POST, PUT, DELETE
Referenz zu Google Sites-Suchparametern
Unterstützte Abfrageparameter des Google Data API-Protokolls:
max-resultspublished-max(nur Inhaltsfeed)published-min(nur Content-Feed)start-indexupdated-maxupdated-minq(vollständige Textabfragen)
Eine Liste der Parameter für die einzelnen Feeds finden Sie oben bei den einzelnen Feeds.