Dieses Dokument enthält eine detaillierte Referenzdokumentation für das Rohprotokoll (XML und HTTP) für das Google Sites Data API.
Dieses Dokument enthält keine Informationen zu den Programmiersprachen-Clientbibliotheken. Referenzinformationen zu Client-Bibliotheken finden Sie unter den Links in den Abschnitten zu den einzelnen Programmiersprachen im Entwicklerhandbuch.
Zielgruppe
Dieses Dokument richtet sich an Programmierer, die Clientanwendungen erstellen 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 sowie die allgemeinen Konzepte des Google Data APIs-Protokolls verstanden haben.
Feedtypen in Google Sites
Das Google Sites Data API bietet die folgenden Feedtypen:
Aktivitätsfeed
Der Aktivitätsfeed ist ein Feed, der Beschreibungen aller Aktivitäten auf einer Website enthält.
Der 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 „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
Inhaltsfeed
Der Content-Feed ist ein Feed mit dem aktuellen, bearbeitbaren Website-Content.
Der 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 „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.
Für Anfragen an diesen Feed ist möglicherweise eine Authentifizierung erforderlich. Dies hängt von den (veröffentlichten) Einstellungen der Website ab.
Unterstützte Anfragetypen: GET
, POST
, PUT
, DELETE
Zusätzlich zu den Standardabfrageparametern der Data API ermöglicht die Sites Data API die folgenden optionalen Parameter, die GET
-Anfragen über den Inhaltsfeed ausgeben:
Parameter | Beschreibung | Typ | Hinweise |
---|---|---|---|
ancestor |
Fordert nur Einträge mit dem angegebenen Ancestor an. | String | Geben Sie die ID des gewünschten Ancestor-Eintrags an. Beispiel: 0123456789 . Gibt alle Einträge zurück, die den angegebenen Ancestor als übergeordnetes Element, als übergeordnetes Element eines übergeordneten Elements usw. haben. |
include-deleted |
Gibt an, ob gelöschte Einträge berücksichtigt werden. | 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 ansehen zu können. |
kind |
Gibt die Art(en) der Inhaltseinträge an, die zurückgegeben werden sollen. Diese 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 |
Fordert nur Einträge mit dem angegebenen übergeordneten Element an. | 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 Überarbeitungsfeed ist ein Feed, der bisherige Überarbeitungen des Websitecontents enthält.
Der 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 „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 Website-Feed können die Google Sites-Websites aufgelistet werden, die einem Nutzer gehören oder für die er eine Anzeigeberechtigung hat. Außerdem können Sie damit neue Websites erstellen, kopieren oder den Namen einer vorhandenen Website ändern.
Feed-URI für den Website-Eintrag:
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, wenn eine GET
-Anforderung zum Auflisten von Websites gesendet wird:
Parameter | Beschreibung | Typ | Hinweise |
---|---|---|---|
include-all-sites |
Geben Sie alle Websites an, die von einem Nutzer in der G Suite-Domain mindestens angesehen werden können. | boolean | Dieser Parameter ist nur beim Auflisten von Websites für eine G Suite-Domain anwendbar. Mögliche Werte sind true oder false . Der Standardwert ist false . |
with-mappings |
Bindet die Zuordnungen der Webadresse in einen Websiteeintrag ein. | boolean | Mögliche Werte sind true und false . Der Standardwert ist false . |
ACL-Feed
Der ACL-Feed kann verwendet werden, um die Freigabeberechtigungen (ACLs) einer Google Sites-Website aufzulisten und/oder zu ändern.
Feed-URI für den Website-Eintrag:
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 aus dem Google Data API-Protokoll:
max-results
published-max
(nur Content-Feed)published-min
(nur Content-Feed)start-index
updated-max
updated-min
q
(vollständige Textabfragen)
Eine Liste der Parameter für den jeweiligen Feed finden Sie bei jedem Feed oben.