Dieses Dokument enthält eine detaillierte Referenzdokumentation für das Rohprotokoll (XML und HTTP) für die Google Sites Data API.
Dieses Dokument enthält keine Informationen zu den Clientbibliotheken für Programmiersprachen. Referenzinformationen zu Clientbibliotheken finden Sie in den Links in den sprachspezifischen Abschnitten des Entwicklerleitfadens.
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, in dem davon ausgegangen wird, dass Sie die Konzepte des Protokollleitfadens und die allgemeinen Ideen hinter dem Google Data APIs-Protokoll kennen.
Google Sites-Feedtypen
Die Google Sites Data API bietet die folgenden Arten von Feeds:
Aktivitätsfeed
Der Aktivitätsfeed enthält Beschreibungen aller Aktivitäten auf einer Website.
Die GET-URI dieses Feeds für eine Website in einer bestimmten Domain lautet:
https://sites.google.com/feeds/activity/domainName/siteName/[activityEntryID]
domainName ist entweder „site“ 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
Inhaltsfeed
Der Content-Feed enthält die aktuellen, bearbeitbaren Websiteinhalte.
Die GET-URI dieses Feeds für eine Website in einer bestimmten Domain lautet:
https://sites.google.com/feeds/content/domainName/siteName/[contentEntryID]
domainName ist entweder „site“ 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.
Für Anfragen an diesen Feed ist je nach den (veröffentlichten) Einstellungen der Website möglicherweise eine Authentifizierung erforderlich.
Unterstützte Anfragetypen: GET, POST, PUT, DELETE
Zusätzlich zu den Standard-Abfrageparametern der Data API sind für die Sites Data API die folgenden optionalen Parameter verfügbar, wenn Sie eine GET-Anfrage über den Content-Feed senden:
| Parameter | Beschreibung | Typ | Hinweise |
|---|---|---|---|
ancestor |
Es werden nur Einträge mit dem angegebenen Ancestor angefordert. | 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, übergeordnetes Element des übergeordneten Elements usw. haben. |
include-deleted |
Gibt an, ob gelöschte Einträge berücksichtigt werden sollen. | boolean | Mögliche Werte sind true und false. Der Standardwert ist false. |
include-draft |
Gibt an, ob Entwurfseinträge berücksichtigt 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 aufrufen zu können. |
kind |
Gibt die Art(en) der zurückzugebenden Inhaltseinträge an. Sie richten sich nach dem Seitentyp in Google Sites. | durch Kommas getrennte Liste von Strings | Mögliche Werte sind announcement, announcementspage, attachment,
comment, filecabinet, listitem, listpage, webpage, webattachment,
template. |
parent |
Es werden nur Einträge mit dem angegebenen übergeordneten Element angefordert. | String | Geben Sie die ID des übergeordneten Eintrags an. Beispiel: 0123456789. |
path |
Inhalte unter einer bestimmten Seitenhierarchie anfordern | String | Der Pfad zu einer Unterseite auf einer Website, für die Inhalte abgerufen werden sollen. Beispiel: path=/path/to/page. |
Versionsfeed
Der Revisionsfeed enthält frühere Versionen von Websiteinhalten.
Die GET-URI dieses Feeds für eine Website in einer bestimmten Domain lautet:
https://sites.google.com/feeds/revision/domainName/siteName/contentEntryID/[revisionEntryID]
domainName ist entweder „site“ 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
Mit dem Websitefeed können die Google Sites aufgelistet werden, die einem Nutzer gehören oder für die er die Berechtigung zum Ansehen hat. Sie können damit auch neue Websites erstellen, Websites kopieren oder den Namen einer vorhandenen Website ändern.
Der Feed-URI für die Sites-Auflistung lautet:
https://sites.google.com/feeds/site/domainName/[siteName]
domainName ist entweder „site“ oder eine G Suite-Domain.
Alle Anfragen an diesen Feed müssen authentifiziert werden.
Unterstützte Anfragetypen: GET, POST, PUT
Der Websitefeed unterstützt die folgenden optionalen Parameter, wenn eine GET-Anfrage für die Auflistung von Websites gesendet wird:
| Parameter | Beschreibung | Typ | Hinweise |
|---|---|---|---|
include-all-sites |
Alle Websites auflisten, 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.
Der Feed-URI für die Sites-Einträge lautet:
https://sites.google.com/feeds/acl/site/domainName/siteName/[aclEntryID]
domainName ist entweder „site“ oder eine G Suite-Domain.
Alle Anfragen an diesen Feed müssen authentifiziert werden.
Unterstützte Anfragetypen: GET, POST, PUT, DELETE
Referenz für Google Sites-Suchparameter
Unterstützte Abfrageparameter aus dem Google Data API-Protokoll:
max-resultspublished-max(nur Content-Feed)published-min(nur Content-Feed)start-indexupdated-maxupdated-minq(Volltextanfragen)
Eine Liste der Parameter, die für die einzelnen Feeds spezifisch sind, finden Sie oben.