Elementy kontaktów udostępnionych

Interfejs Domain Shared Contacts API używa standardowych elementów interfejsu Google Data API oraz elementów przeznaczonych do pracy z kontaktami udostępnionymi.

Wpis kontaktowy ma postać rozszerzonego rodzaju kontaktu, który reprezentuje osobę, miejsce (np. klub lub restaurację) lub organizację. Rodzaj kontaktu jest widoczny w pliku XML jako element <atom:entry> zawierający 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 atrybut 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 parametr rel, jak i label albo żaden z tych elementów, serwer odrzuci wpis.

Pomoc dotycząca Zdjęć

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

  • W przypadku polecenia GET komenda 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 href, aby odczytać najnowszą wersję zdjęcia powiązanego z kontaktem. Link nie jest wyświetlany, jeśli 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/*" />
  • W przypadku polecenia PUT lub DELETE komenda rel="http://schemas.google.com/contacts/2008/rel#edit-photo" umożliwia zaktualizowanie lub usunięcie 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 zdefiniowano 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ła osoba kontaktowa. Grupa jest wskazywana za pomocą identyfikatora.
deleted="true" Oznacza to, że kontakt nie jest już członkiem grupy. Ten atrybut jest uwzględniany tylko wtedy, gdy jako parametr zapytania podano wartość showdeleted. W przeciwnym razie groupMembershipInfo dla grup, do których kontakt już nie należy, nie jest zwracany.