Elemente für freigegebene Kontakte

Die Domain Shared Contacts API verwendet die Google Data API-Standardelemente und -Elemente, die für gemeinsame Kontakte spezifisch sind.

Ein Kontakteintrag ist eine erweiterte Kontaktart und steht für eine Person, einen Veranstaltungsort (z. B. 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 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 Kontaktart. 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 gemeinsamen 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.

Support für Google Fotos

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

  • Mit einem GET-Befehl fügt rel="http://schemas.google.com/contacts/2008/rel#photo" die Funktion zum Lesen des Fotos hinzu, das mit dem Kontakt verknüpft ist. Sie können die in href angegebene URL verwenden, um die neueste Version des Fotos zu lesen, das mit dem Kontakt verknüpft 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 dem Befehl PUT oder DELETE kann rel="http://schemas.google.com/contacts/2008/rel#edit-photo" ein mit dem Kontakt verknüpftes lokales Foto aktualisieren oder 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 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

Property Beschreibung
href Kennzeichnet die Gruppe, zu der der Kontakt gehört oder zu der der Kontakt gehört. Die Gruppe wird über ihre ID referenziert.
deleted="true" Das bedeutet, dass die Gruppenzugehörigkeit für den Kontakt entfernt wurde. 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.