Elementy kontaktów udostępnionych

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 polu href. 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 lub DELETE 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.