Elementy kontaktów udostępnionych

Interfejs Domain Shared Contacts API używa standardowych elementów Google Data API oraz elementów specyficznych dla udostępnionych kontaktów.

Wpis kontaktu ma postać rozszerzonego rodzaju 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 rozszerzenia 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 podajesz atrybut rel lub label, ale nie oba:

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

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

Obsługa zdjęć

Oprócz wartości standardowych właściwości, takich jak self czy edit, możesz używać wartości rel w przypadku elementów atom:link. Gdy używasz linków do zdjęć, w nagłówku HTTP musisz podać token autoryzacji. Więcej informacji znajdziesz w artykule Informacje o uwierzytelnianiu i autoryzacji.

• Polecenie GET z atrybutem rel="http://schemas.google.com/contacts/2008/rel#photo" umożliwia odczytanie zdjęcia powiązanego z kontaktem. Możesz użyć adresu URL podanego w atrybucie 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/*" />

• Polecenie PUT lub DELETE rel="http://schemas.google.com/contacts/2008/rel#edit-photo" umożliwia aktualizowanie lub usuwanie 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 gContact to http://schemas.google.com/contact/2008.

W tej przestrzeni nazw zdefiniowany jest element reprezentujący grupę, do której należy kontakt.

Właściwości gContact:groupMembershipInfo

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, że członkostwo w grupie zostało usunięte w przypadku tego kontaktu. Ten atrybut jest uwzględniany tylko wtedy, gdy jako parametr zapytania podano showdeleted. W przeciwnym razie element groupMembershipInfo w przypadku grup, do których kontakt już nie należy, nie jest zwracany.