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

Ein Kontakteintrag hat die Form einer erweiterten Kontaktart und steht für eine Person, einen Veranstaltungsort wie einen Club oder ein Restaurant oder eine Organisation. 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 es sich bei dem Eintrag um einen Kontakt handelt, 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 einige Elemente etwas restriktiver als die Kontaktart. Geben Sie für die folgenden Elemente 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 für eines dieser Elemente sowohl rel als auch label oder keines davon angeben, lehnt der Server den Eintrag ab.

Google Fotos-Support

Neben den Werten standardmäßiger Properties wie „self“ oder „edit“ können Sie auch rel-Werte für atom:link-Elemente verwenden. Wenn du Fotolinks verwendest, muss das Autorisierungstoken im HTTP-Header angegeben werden. Weitere Informationen finden Sie unter Authentifizierung und Autorisierung.

  • Mit einem 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. Über die in href angegebene URL können Sie die neueste Version des Fotos abrufen, das mit dem Kontakt verknüpft ist. Der Link wird nicht angezeigt, wenn für den Kontakt kein Bild 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 bietet rel="http://schemas.google.com/contacts/2008/rel#edit-photo" die Möglichkeit, ein lokales Foto zu aktualisieren oder zu löschen, das mit dem Kontakt verknüpft ist.

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 lautet 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" Die Gruppenmitgliedschaft wurde für den Kontakt entfernt. Dieses Attribut ist nur enthalten, wenn showdeleted als Abfrageparameter angegeben ist. Andernfalls wird groupMembershipInfo für Gruppen, zu denen ein Kontakt nicht mehr gehört, nicht zurückgegeben.