Referenzleitfaden

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.

Nach oben