Rozszerzone właściwości i prognozy

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

Właściwości rozszerzone

W przypadku udostępnionego kontaktu możesz ustawić dodatkowe informacje o nim jako rozszerzoną właściwość z dowolnymi parami nazwa-wartość. Twoim obowiązkiem jest dbanie o niepowtarzalność kluczy. Wartość rozszerzonej właściwości może być przechowywana jako wartość (dowolny ciąg znaków) lub blok danych XML (zwykły tekst). Każdy udostępniony kontakt może mieć maksymalnie 10 rozszerzonych właściwości. Każda rozszerzona właściwość powinna być stosunkowo mała. Nie używaj zdjęć ani dzwonków.

Przykład

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

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

Ten przykład pokazuje rozszerzoną właściwość z kluczem i ciągiem znaków 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 prognozy

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

W tabeli poniżej opisano obsługiwane wartości projekcji:

Nazwa projekcji Opis
thin Elementy gd:extendedProperty nie są zwracane ani aktualizowane.
property-KEY KEY wskazuje klucz rozszerzonej właściwości (elementu gd:extendedProperty), która jest zwracana (w przypadku żądań GET) lub powinna zostać zaktualizowana (w przypadku żądań PUT lub POST). Jeśli rozszerzona właściwość nie jest używana podczas operacji aktualizacji, zostaje usunięta.
full Wszystkie elementy gd:extendedProperty są zwracane, a podczas aktualizacji należy uwzględnić wszystkie elementy.