Erweiterte Attribute und Projektionen

Verwenden Sie erweiterte Eigenschaften und Projektionen, um benutzerdefinierte Eigenschaften für einen gemeinsamen Kontakt zu definieren.

Erweiterte Properties

Sie können zusätzliche Informationen zu freigegebenen Kontakten als erweiterte Eigenschaft mit beliebigen Name/Wert-Paaren für einen freigegebenen Kontakteintrag festlegen. Es liegt in Ihrer Verantwortung, die Einzigartigkeit des Schlüssels zu bewahren. Der Wert eines erweiterten Attributs kann als Wert (beliebiger String) oder als XML-Blob (Klartext) gespeichert werden. Jedem freigegebenen Kontakt können maximal zehn erweiterte Eigenschaften zugeordnet sein. Jede erweiterte Eigenschaft sollte relativ klein sein. Verwenden Sie weder ein Foto noch einen Klingelton.

Beispiel

Das folgende Beispiel zeigt eine erweiterte Property mit einem Schlüssel und einem Wert:

&lt;gd:extendedProperty name="com.google" value="<var>VALUE</var>"/&gt;

Das folgende Beispiel zeigt ein erweitertes Attribut mit einem Schlüssel und einem XML-Blob:

&lt;gd:extendedProperty name="com.google"&gt;
  &lt;<var>XML_PARAMETER</var>&gt;&lt;/<var>XML_PARAMETER</var>&gt;
&lt;/gd:extendedProperty>

Projektionswerte

Verwenden Sie Projektionen, um die Sichtbarkeit von erweiterten Properties einzuschränken. Das Festlegen von erweiterten Attributen (gd:extendedElement-Elementen) ist nur innerhalb einer full- oder property-KEY-Projektion zulässig.

In der folgenden Tabelle werden die unterstützten Projektionswerte beschrieben:

Name der Projektion Beschreibung
thin Es werden keine gd:extendedProperty-Elemente zurückgegeben oder aktualisiert.
property-KEY KEY gibt den Schlüssel eines erweiterten Attributs (gd:extendedProperty-Element) an, das zurückgegeben wird (bei GET-Anfragen) oder aktualisiert werden soll (bei PUT- oder POST-Anfragen). Wenn das erweiterte Attribut bei Aktualisierungsvorgängen nicht verwendet wird, wird es gelöscht.
full Alle gd:extendedProperty-Elemente werden zurückgegeben und alle Elemente müssen bei einer Aktualisierung einbezogen werden.