Rozszerzone właściwości i prognozy

Aby określić niestandardowe cechy udostępnianego kontaktu, użyj właściwości rozszerzonych i prognoz.

Właściwości rozszerzone

Dodatkowe udostępniane informacje kontaktowe możesz ustawić jako rozszerzone z dowolnymi parami nazwa-wartość dla wpisu kontaktu udostępnionego. Jest z obowiązku zachowania oryginalności kluczy. Wartość rozszerzenia może być przechowywana jako wartość (dowolny ciąg znaków) lub obiekt blob XML (zwykły tekst). Z każdym udostępnionym kontaktem może być powiązanych maksymalnie 10 usług rozszerzonych. Każda rozszerzona właściwość powinna być odpowiednio mała; Nie używaj zdjęcia ani .

Przykład

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

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

Poniższy przykład pokazuje rozszerzoną właściwość 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 prognozy

Aby ograniczyć rozszerzoną widoczność usługi, używaj prognoz. Ustawienie rozszerzone (elementy gd:extendedElement) są dozwolone tylko w obrębie full albo Prognoza property-KEY.

W poniższej tabeli opisano obsługiwane wartości prognozy:

Nazwa projekcji Opis
thin nie są zwracane żadne elementy gd:extendedProperty lub Zaktualizowano.
property-KEY KEY wskazuje klucz rozszerzenia rozszerzonego właściwość (element gd:extendedProperty), która jest zwracana (w przypadku żądań GET) lub powinny zostać zaktualizowane (w przypadku PUT lub POST). Jeśli rozszerzony nie jest używana podczas operacji aktualizacji, Usunięto.
full Wszystkie elementy gd:extendedProperty są zwracane. wszystkie elementy muszą być uwzględnione podczas aktualizacji.