Erweiterte Attribute und Projektionen

Wenn Sie benutzerdefinierte Merkmale für einen freigegebenen Kontakt definieren möchten, verwenden Sie erweiterte Properties und Projektionen.

Erweiterte Eigenschaften

Sie können zusätzliche Informationen zu freigegebenen Kontakten als erweiterte Eigenschaft mit beliebigen Name/Wert-Paaren für einen Eintrag für freigegebene Kontakte festlegen. Sie sind dafür verantwortlich, dass die Schlüssel eindeutig sind. Der Wert einer erweiterten Eigenschaft kann als Wert (beliebiger String) oder als XML-Blob (reiner Text) gespeichert werden. Jedem freigegebenen Kontakt können maximal 10 erweiterte Attribute zugeordnet sein. Jede erweiterte Property sollte relativ klein sein. Verwenden Sie kein Foto oder keinen Klingelton.

Beispiel

Das folgende Beispiel zeigt eine erweiterte Eigenschaft 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 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>

Prognosewerte

Verwenden Sie Projektionen, um die Sichtbarkeit erweiterter Attribute einzuschränken. Das Festlegen erweiterter Eigenschaften (gd:extendedElement-Elemente) 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 einer erweiterten Eigenschaft (gd:extendedProperty-Element) an, die zurückgegeben wird (für GET-Anfragen) oder aktualisiert werden soll (für eine PUT- oder POST-Anfrage). Wenn die erweiterte Property bei Aktualisierungsvorgängen nicht verwendet wird, wird sie gelöscht.
full Alle gd:extendedProperty-Elemente werden zurückgegeben und müssen bei einer Aktualisierung berücksichtigt werden.