Am 22. November 2016 wurde eine neue Version von Google Sites veröffentlicht. Die Sites API kann nicht auf Websites zugreifen oder sie ändern, die mit dieser Version erstellt wurden, aber auf das klassische Google Sites zugreifen.

Referenzleitfaden

Dieses Dokument enthält eine detaillierte Referenz 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 unter den Links in den Abschnitten zu den einzelnen Programmiersprachen im Entwicklerleitfaden.

Zielgruppe

Dieses Dokument richtet sich an Programmierer, die Client-Anwendungen schreiben möchten, die mit Google Sites interagieren können.

Es ist ein Referenzdokument. Es wird davon ausgegangen, dass Sie mit den Konzepten im Protokollleitfaden und den allgemeinen Ideen hinter dem Google Data APIs-Protokoll vertraut sind.

Google Sites-Feedtypen

Die Google Sites Data API bietet folgende Feedtypen:

Aktivitäts-Feed

Der Aktivitätsfeed ist ein Feed mit Beschreibungen aller Aktivitäten auf einer Website.

Der GET-URI dieses Feeds für eine Website in einer bestimmten Domain ist:

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 enthalten ist: http://sites.google.com/a/domainName/siteName/.

Alle Anfragen an diesen Feed müssen authentifiziert sein.

Unterstützte Anfragetypen: GET

Inhaltsfeed

Der Contentfeed ist ein Feed mit dem aktuellen, bearbeitbaren Websitecontent.

Der GET-URI dieses Feeds für eine Website in einer bestimmten Domain ist:

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 enthalten ist: http://sites.google.com/a/domainName/siteName.

Anfragen an diesen Feed können abhängig von den Einstellungen der Website (veröffentlicht) eine Authentifizierung erfordern oder nicht.

Unterstützte Anfragetypen: GET, POST, PUT, DELETE

Zusätzlich zu den standardmäßigen Abfrageparametern der Data API lässt die Sites Data API die folgenden optionalen Parameter zu, die mithilfe des Contentfeeds die Anfrage GET senden:

Parameter Beschreibung Typ Hinweise
ancestor Fordert nur Einträge mit dem angegebenen Vorgänger an. string Geben Sie die ID des gewünschten Vorgängereintrags an. Beispiel: 0123456789 Gibt alle Einträge zurück, die den angegebenen Vorgänger als übergeordneten Element, als übergeordneten Namen usw. haben.
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 der Inhaber oder Autor des Entwurfs sein, um ihn aufrufen zu können.
kind Gibt die Art der Inhaltseinträge an, die zurückgegeben werden sollen. Diese folgen dem Seitentyp in Google Sites. Durch Kommas getrennte Liste von Strings Mögliche Werte sind announcement, announcementspage, attachment, comment, filecabinet, listitem, listpage, webpage, webattachment und 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 enthält frühere Überarbeitungen des Websitecontents.

Der GET-URI dieses Feeds für eine Website in einer bestimmten Domain ist:

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 enthalten ist: http://sites.google.com/a/domainName/siteName.

Alle Anfragen an diesen Feed müssen authentifiziert sein.

Unterstützte Anfragetypen: GET

Websitefeed

Mit dem Websitefeed können Sie die Google Sites-Websites auflisten, die einem Nutzer gehören oder für die er Leseberechtigungen hat. Sie können damit auch neue Websites erstellen, kopieren oder den Namen einer vorhandenen Website ändern.

Der Feed-URI für den Google Sites-Eintrag ist:

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 sein.

Unterstützte Anfragetypen: GET, POST, PUT

Der Websitefeed unterstützt die folgenden (optionalen) Parameter, wenn eine GET-Anfrage zum Auflisten von Websites gesendet wird:

Parameter Beschreibung Typ Hinweise
include-all-sites Hiermit werden alle Websites aufgelistet, die für den Nutzer mindestens in der G Suite-Domain sichtbar sind. boolean Dieser Parameter gilt nur beim Auflisten von Websites für eine G Suite-Domain. Mögliche Werte sind true und false. Der Standardwert ist false.
with-mappings Beinhaltet die Webadressenzuordnungen 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 einer Google Sites-Website auflisten und/oder ändern.

Der Feed-URI für den Google Sites-Eintrag ist:

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 sein.

Unterstützte Anfragetypen: GET, POST, PUT, DELETE

Referenz zu Google Sites-Abfrageparametern

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)

In den einzelnen Feeds finden Sie eine Liste der entsprechenden Parameter.

Nach oben