Erweiterte Attribute und Projektionen

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

Erweiterte Attribute

Sie können zusätzliche Informationen zu freigegebenen Kontakten als erweiterte Property mit beliebigen Namen/Wert-Paaren für einen Eintrag für einen freigegebenen Kontakt festlegen. Sie sind dafür verantwortlich, dass die Schlüssel eindeutig sind. Der Wert einer erweiterten Property kann als Wert (beliebiger String) oder als XML-Blob (Nur-Text) gespeichert werden. Jedem freigegebenen Kontakt können maximal 10 erweiterte Properties zugeordnet werden. Jede erweiterte Property sollte relativ klein sein. Verwenden Sie keine Fotos oder Klingeltöne.

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 eine erweiterte Property 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>

Projektionswerte

Wenn Sie die Sichtbarkeit der erweiterten Property einschränken möchten, verwenden Sie Projektionen. Das Festlegen erweiterter Eigenschaften (gd:extendedElement-Elemente) ist nur innerhalb einer full- oder property-KEY-Projektion zulässig.

In der folgenden Tabelle sind 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 Property (gd:extendedProperty-Element) an, die zurückgegeben (bei GET-Anfragen) oder aktualisiert werden soll (bei einer 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 einem Update enthalten sein.