Pobieranie kontaktów udostępnionych

Możesz poprosić o dostęp do udostępnionych kontaktów użytkowników na kilka sposobów:

  • Wszystkie kontakty udostępnione
  • zbiór kontaktów spełniających określone kryteria,
  • Jeden kontakt udostępniony
  • Zdjęcie kontaktu

Domyślnie wpisy w kanale nie są uporządkowane.

Pobierz wszystkie kontakty udostępnione

  1. Aby pobrać wszystkie kontakty udostępnione, wyślij żądanie HTTP GET na adres URL kanału kontaktów:

    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION

    Zastąp następujące elementy:

    • DOMAIN: adres URL Twojej domeny, na przykład example.com.
    • PROJECTION: wartość odwzorowania określająca elementy gd:extendedProperty. Listę obsługiwanych wartości znajdziesz w sekcji Wartości odwzorowania.

    Plik danych zwraca kod stanu HTTP 200 OK i standardowy plik danych Atom 1.0 z kontaktami. Oto przykład kanału kontaktów z tylko jednym wpisem:

    <feed xmlns='http://www.w3.org/2005/Atom'
    xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
    xmlns:gd='http://schemas.google.com/g/2005'
    xmlns:gContact='http://schemas.google.com/contact/2008'
    xmlns:batch='http://schemas.google.com/gdata/batch'>
  <id>https://www.google.com/m8/feeds/contacts/example.com/base</id>
  <updated>2008-03-05T12:36:38.836Z</updated>
  <category scheme='http://schemas.google.com/g/2005#kind'
    term='http://schemas.google.com/contact/2008#contact' />
  <title type='text'>example.com's Contacts</title>
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full' />
  <link rel='http://schemas.google.com/g/2005#post'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full' />
  <link rel='http://schemas.google.com/g/2005#batch'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full/batch' />
  <link rel='self' type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full?max-results=25' />
  <author>
    <name>example.com</name>
    <email>example.com</email>
  </author>
  <generator version='1.0' uri='https://www.google.com/m8/feeds/contacts'>
    Contacts
  </generator>
  <openSearch:totalResults>1</openSearch:totalResults>
  <openSearch:startIndex>1</openSearch:startIndex>
  <openSearch:itemsPerPage>25</openSearch:itemsPerPage>
  <entry>
    <id>
      https://www.google.com/m8/feeds/contacts/example.com/base/c9012de
    </id>
    <updated>2008-03-05T12:36:38.835Z</updated>
    <category scheme='http://schemas.google.com/g/2005#kind'
      term='http://schemas.google.com/contact/2008#contact' />
    <title type='text'>Fitzgerald</title>
    <gd:name>
      <gd:fullName>Fitzgerald</gd:fullName>
    </gd:name>
    <link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*"
      href="http://google.com/m8/feeds/photos/media/example.com/c9012de"/>
    <link rel='self' type='application/atom+xml'
      href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de' />
    <link rel='edit' type='application/atom+xml'
      href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de/1204720598835000' />
    <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'
      primary='true'>
      456
    </gd:phoneNumber>
    <gd:extendedProperty name="pet" value="hamster" />
  </entry>
</feed>

  2. Kanał nie zwraca w jednej odpowiedzi więcej niż 10 MB. Aby pobrać całą listę kontaktów, klikaj link Dalej w zwracanym pliku danych, aż nie będzie go już widać w pliku zwrotnym.

Pobierz kontakty udostępnione przy użyciu parametrów zapytania

Możesz zgłosić zbiór kontaktów spełniających określone kryteria, np. poprosić o zaktualizowanie kontaktów po określonej dacie. Nie obsługujemy zapytań pełnotekstowych ani lokalizowania kontaktów według adresu e-mail. Pełną listę obsługiwanych parametrów zapytania znajdziesz w przewodniku po interfejsie Domain Shared Contacts API.

  1. Wyślij żądanie HTTP GET do adresu URL kanału kontaktów ze zdefiniowanym parametrem:

    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION?PARAMETER

    Zastąp następujące elementy:

    Aby na przykład zaktualizować po 16 marca 2022 r. wszystkie kontakty udostępnione w domenie, np. example.com, wyślij żądanie HTTP na adres URL udostępnionego kanału kontaktów w domenie i dodaj do niego parametr updated-min:

    GET https://www.google.com/m8/feeds/contacts/example.com/full?updated-min=2022-03-16T00:00:00

    Gdy wysyłasz to żądanie GET, serwer zwraca kod stanu HTTP 200 OK i plik danych zawierający kontakty udostępnione w domenie, które zostały utworzone lub zaktualizowane po określonej dacie.

  2. Kanał nie zwraca w jednej odpowiedzi więcej niż 10 MB. Aby pobrać całą listę kontaktów z określonymi kryteriami, klikaj link Dalej w zwracanym pliku danych, aż nie będzie go już widać w pliku zwrotnych.

Śledzenie zmian przyrostowych

Aby śledzić przyrostowe zmiany listy kontaktów udostępnionych w domenie, wykonaj te czynności: 1. Gdy wysyłasz żądanie pliku danych, śledź wartość jego elementu <updated>. 1. Aby uzyskać tylko kontakty udostępnione w domenie, które zmieniły się od poprzedniego żądania, ustaw parametr zapytania updated-min na tę wartość <updated>, a ustaw showdeleted na true.

Pobieranie pojedynczego kontaktu udostępnionego

Aby zobaczyć pojedynczy kontakt udostępniony, musisz użyć własnego linku. Aby uzyskać własny link do kontaktu udostępnionego, znajdź jego wpis w kanale kontaktów udostępnionych. Jeśli nie masz pewności, jakiej wartości użyć w przypadku własnego linku, przeczytaj artykuły na temat pobierania wszystkich kontaktów i pobierania kontaktów za pomocą parametrów zapytania.

  1. Aby uzyskać dostęp do określonego kontaktu udostępnionego w domenie, wyślij żądanie HTTP GET na własny link do kontaktu: 
    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/:SELF_LINK>
    Zastąp to:
  • DOMAIN: adres URL Twojej domeny, na przykład example.com.
  • PROJECTION: wartość odwzorowania określająca elementy gd:extendedProperty. Listę obsługiwanych wartości znajdziesz w sekcji Wartości odwzorowania.
  • SELF_LINK: niepowtarzalna wartość liczbowa reprezentująca pojedynczy kontakt udostępniony, np. 12345.

Serwer zwraca wtedy kod stanu HTTP 200 OK i wpis zawierający kontakt.

Jeśli na przykład chcesz, aby kontakt udostępniony w domenie miał link własny ustawiony na https://www.google.com/m8/feeds/contacts/example.com/full/12345, wyślij to żądanie HTTP:

GET https://www.google.com/m8/feeds/contacts/example.com/full/12345

Dalsze kroki