Elemente für freigegebene Kontakte

Die Domain Shared Contacts API verwendet die Standardelemente der Google Data API und Elemente, die speziell für freigegebene Kontakte gelten.

Ein Kontakteintrag hat die Form einer erweiterten Kontaktart, die eine Person, einen Ort (z. B. einen Club oder ein Restaurant) oder eine Organisation darstellt. Die Kontaktart wird in XML als <atom:entry>-Element angezeigt, das verschiedene Erweiterungselemente aus dem Google Data-Namespace enthält.

Das category-Element, das angibt, dass der Eintrag ein Kontakt ist, sieht so aus:

<atom:category scheme="http://schemas.google.com/g/2005#kind"
  term="http://schemas.google.com/contact/2008#contact"/>

In der Domain Shared Contacts API sind mehrere Elemente etwas restriktiver als die Art des Kontakts. Für die folgenden Elemente geben Sie entweder ein rel-Attribut oder ein label-Attribut an, aber nicht beides:

  • gd:email
  • gd:im
  • gd:organization
  • gd:phoneNumber
  • gd:structuredPostalAddress

Wenn Sie einen freigegebenen Kontakt erstellen oder aktualisieren und sowohl rel als auch label oder keines von beiden für eines dieser Elemente angeben, lehnt der Server den Eintrag ab.

Google Fotos-Support

Zusammen mit den Werten von Standardattributen wie „self“ oder „edit“ können Sie rel-Werte für atom:link-Elemente verwenden. Bei Verwendung von Fotolinks muss das Autorisierungstoken im HTTP-Header angegeben werden. Weitere Informationen finden Sie unter Authentifizierung und Autorisierung.

  • Mit dem GET-Befehl fügt rel="http://schemas.google.com/contacts/2008/rel#photo" die Möglichkeit hinzu, das mit dem Kontakt verknüpfte Foto zu lesen. Sie können die in href angegebene URL verwenden, um die aktuelle Version des Fotos zu lesen, das dem Kontakt zugeordnet ist. Der Link wird nicht angezeigt, wenn kein Bild für den Kontakt vorhanden ist.

Beispiel:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234" type="image/*" />
  • Mit einem PUT- oder DELETE-Befehl fügt rel="http://schemas.google.com/contacts/2008/rel#edit-photo" die Möglichkeit hinzu, ein lokales Foto, das dem Kontakt zugeordnet ist, zu aktualisieren oder zu löschen.

Beispiel:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#edit-photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234/photo4524" />

gContactNamespace:

Die XML-Namespace-URL für gContact ist http://schemas.google.com/contact/2008.

In diesem Namespace wird ein Element definiert, das eine Gruppe darstellt, zu der der Kontakt gehört.

gContact:groupMembershipInfo Unterkünfte

Attribut Beschreibung
href Gibt die Gruppe an, zu der der Kontakt gehört oder gehörte. Auf die Gruppe wird über ihre ID verwiesen.
deleted="true" Das bedeutet, dass die Gruppenmitgliedschaft für den Kontakt entfernt wurde. Dieses Attribut ist nur enthalten, wenn showdeleted als Abfrageparameter angegeben ist. Andernfalls wird groupMembershipInfo für Gruppen, denen ein Kontakt nicht mehr angehört, nicht zurückgegeben.