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ą:
<gd:extendedProperty name="com.google" value="<var>VALUE</var>"/>
Ten przykład przedstawia rozszerzoną właściwość z kluczem i blobem XML:
<gd:extendedProperty name="com.google">
<<var>XML_PARAMETER</var>></<var>XML_PARAMETER</var>>
</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. |