Rozszerzone właściwości i prognozy

Aby zdefiniować niestandardowe cechy kontaktu udostępnionego, użyj właściwości rozszerzonych i projekcji.

Właściwości rozszerzone

Możesz ustawić dodatkowe informacje o wspólnym kontakcie jako właściwość rozszerzoną z dowolnymi parami nazwa-wartość dla wpisu wspólnego kontaktu. Twoim obowiązkiem jest zachowanie niepowtarzalności klucza. Wartość właściwości rozszerzonej można przechowywać jako wartość (dowolny ciąg znaków) lub jako obiekt binarny XML (zwykły tekst). Każdy udostępniony kontakt może mieć maksymalnie 10 powiązanych właściwości rozszerzonych. Każda właściwość rozszerzona powinna być stosunkowo mała. Nie używaj zdjęcia ani dzwonka.

Przykład

Poniższy przykład pokazuje właściwość rozszerzoną z kluczem i wartością:

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

Poniższy przykład przedstawia właściwość rozszerzoną z kluczem i obiektem blob XML:

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

Wartości prognozowane

Aby ograniczyć widoczność właściwości rozszerzonych, użyj projekcji. Ustawianie właściwości rozszerzonych (elementów gd:extendedElement) jest dozwolone tylko w projekcji full lub property-KEY.

W tabeli poniżej znajdziesz opis obsługiwanych wartości prognozowania:

Nazwa prognozy Opis
thin Nie są zwracane ani aktualizowane żadne elementy gd:extendedProperty.
property-KEY KEY wskazuje klucz rozszerzonej właściwości (element gd:extendedProperty), która jest zwracana (w przypadku żądań GET) lub powinna zostać zaktualizowana (w przypadku żądań PUT lub POST). Jeśli właściwość rozszerzona nie jest używana podczas operacji aktualizacji, zostaje usunięta.
full Zwracane są wszystkie elementy gd:extendedProperty i wszystkie muszą być uwzględnione podczas aktualizacji.