Elementy kontaktów udostępnionych

Interfejs Domain Shared Contacts API korzysta ze standardowych elementów interfejsu Google Data API i elementów specyficznych dla kontaktów udostępnionych.

Wpis kontaktu ma postać rozszerzonego typu kontaktu, który reprezentuje osobę, miejsce, np. klub lub restaurację, albo organizację. Rodzaj kontaktu jest wyświetlany w XML jako element <atom:entry>, który zawiera różne elementy rozszerzające z przestrzeni nazw Google Data.

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 Domain Shared Contacts API kilka elementów jest nieco bardziej restrykcyjnych niż rodzaj kontaktu. W przypadku tych elementów podaj atrybut rel lub atrybut label, ale nie oba jednocześnie:

  • gd:email
  • gd:im
  • gd:organization
  • gd:phoneNumber
  • gd:structuredPostalAddress

Jeśli podczas tworzenia lub aktualizowania udostępnionego kontaktu podasz zarówno rel, jak i label, lub nie podasz żadnego z tych elementów, serwer odrzuci wpis.

Pomoc dotycząca Zdjęć

Oprócz wartości standardowych właściwości, takich jak self czy edit, możesz używać wartości relw przypadku elementów atom:link. W przypadku korzystania z linków do zdjęć w nagłówku HTTP musi być określony token autoryzacji. Więcej informacji znajdziesz w artykule Uwierzytelnianie i autoryzacja.

  • Za pomocą polecenia GETrel="http://schemas.google.com/contacts/2008/rel#photo" dodaje możliwość odczytania zdjęcia powiązanego z kontaktem. Możesz użyć adresu URL podanego w href, aby odczytać najnowszą wersję zdjęcia powiązanego z kontaktem. Jeśli kontakt nie ma zdjęcia, link nie jest wyświetlany.

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/*" />
  • Za pomocą polecenia PUT lub DELETErel="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" />

gContact przestrzeń nazw

Adres URL przestrzeni nazw XML dla 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ży lub należał kontakt. Grupa jest określana za pomocą identyfikatora.
deleted="true" Oznacza to, że członkostwo w grupie zostało usunięte dla kontaktu. Ten atrybut jest uwzględniany tylko wtedy, gdy showdeleted jest określony jako parametr zapytania. W przeciwnym razie groupMembershipInfo w przypadku grup, do których kontakt już nie należy, nie jest zwracany.