Rozszerzone właściwości i prognozy

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

Właściwości rozszerzone

W przypadku wpisu kontaktu udostępnionego możesz ustawić dodatkowe udostępniane informacje kontaktowe jako właściwość rozszerzoną, korzystając z dowolnych par nazwa-wartość. To Ty odpowiadasz za zachowanie niepowtarzalności klucza. Wartość rozszerzonej właściwości można przechowywać jako wartość (dowolny ciąg znaków) lub obiekt blob XML (zwykły tekst). Z każdym kontaktem udostępnionym może być powiązanych maksymalnie 10 usług rozszerzonych. Każda rozszerzona właściwość powinna być wystarczająco mała. Nie używaj zdjęć ani dzwonków.

Przykład

Poniższy 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 przedstawia rozszerzoną właściwość z kluczem i blobem 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 projekcji

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

Obsługiwane wartości odwzorowania są opisane w tabeli poniżej:

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