Interfejs API kontaktów udostępnionych w domenie korzysta ze standardowych elementów interfejsu Google Data API oraz elementów specyficznych dla kontaktów udostępnionych.
Kontakt ma formę rozszerzonego rodzaju kontaktu i reprezentuje osobę, miejsce (np. klub, restaurację) lub organizację. Rodzaj kontaktu jest widoczny w kodzie XML jako element <atom:entry>
, który zawiera różne elementy rozszerzeń z przestrzeni nazw danych Google.
Element category
wskazujący, że wpis jest kontaktem, wygląda tak:
<atom:category scheme="http://schemas.google.com/g/2005#kind"
term="http://schemas.google.com/contact/2008#contact"/>
W interfejsie API do udostępniania kontaktów niektóre elementy są nieco bardziej restrykcyjne niż rodzaj kontaktu. W przypadku tych elementów podajesz atrybut rel
lub label
, ale nie oba te elementy:
gd:email
gd:im
gd:organization
gd:phoneNumber
gd:structuredPostalAddress
Gdy utworzysz lub zaktualizujesz kontakt udostępniony, a w przypadku któregoś z tych elementów podasz zarówno rel
, jak i label
lub żaden z tych elementów, serwer odrzuci ten wpis.
Pomoc dotycząca Zdjęć
W połączeniu z wartościami właściwości standardowych, takimi jak „self” czy „edit” możesz używać wartości rel
dla elementów atom:link
. Gdy używasz linków do zdjęć, musisz określić token autoryzacji w nagłówku HTTP. Więcej informacji znajdziesz w artykule o uwierzytelnianiu i autoryzacji.
- Polecenie
GET
rel="http://schemas.google.com/contacts/2008/rel#photo"
dodaje możliwość odczytu zdjęcia powiązanego z kontaktem. Aby przeczytać najnowszą wersję zdjęcia powiązanego z kontaktem, możesz użyć adresu URL podanego w poluhref
. Link nie wyświetla się, gdy nie ma zdjęcia kontaktu.
Przykład:
<atom:link rel="http://schemas.google.com/contacts/2008/rel#photo"
href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234" type="image/*" />
- Polecenie
PUT
lubDELETE
rel="http://schemas.google.com/contacts/2008/rel#edit-photo"
dodaje możliwość aktualizowania lub usuwania lokalnego zdjęcia powiązanego z kontaktem.
Przykład:
<atom:link rel="http://schemas.google.com/contacts/2008/rel#edit-photo"
href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234/photo4524" />
Przestrzeń nazw gContact
Adres URL przestrzeni nazw XML dla elementu gContact
to http://schemas.google.com/contact/2008
.
W tej przestrzeni nazw zdefiniowany jest element reprezentujący grupę, do której należy kontakt.
gContact:groupMembershipInfo
miejsca zakwaterowania
Właściwość | Opis |
---|---|
href |
Określa grupę, do której należał kontakt. Do grupy odwołuje się jej identyfikator. |
deleted="true" |
Oznacza, że członkostwo w grupie zostało usunięte z kontaktu. Ten atrybut jest uwzględniany tylko wtedy, gdy jako parametr zapytania określono showdeleted . W przeciwnym razie wartość groupMembershipInfo w przypadku grup, do których nie należy kontakt, nie będzie zwracana. |