Elementy kontaktów udostępnionych

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

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ż typ 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 lub 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. Aby odczytać najnowszą wersję zdjęcia powiązanego z kontaktem, możesz użyć adresu URL podanego w polu href. 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.