Pobieranie kontaktów udostępnionych

Możesz poprosić o kontakty współdzielonego użytkownika na różne sposoby:

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

Domyślnie wpisy w pliku danych nie są uporządkowane.

Pobieranie wszystkich udostępnionych kontaktów

  1. Aby pobrać wszystkie udostępnione kontakty, 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, np. example.com.
    • PROJECTION: wartość projekcji określająca elementy gd:extendedProperty. Listę obsługiwanych wartości znajdziesz w artykule Wartości projekcji.

    Kanał zwraca kod stanu HTTP 200 OK i standardowy kanał Atom 1.0 zawierający kontakty. Poniżej znajduje się przykład kanału kontaktów z 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 więcej niż 10 MB w jednej odpowiedzi. Aby uzyskać całą listę kontaktów, klikaj kolejno link Dalej zwracanego pliku danych, aż nie będzie już widoczny.

Pobieranie udostępnionych kontaktów za pomocą parametrów zapytania

Możesz poprosić o utworzenie zbioru kontaktów, które spełniają określone kryteria, np. kontaktów zaktualizowanych po określonej dacie. Nie obsługujemy zapytań pełnego tekstu ani znajdowania kontaktu według adresu e-mail. Pełną listę obsługiwanych parametrów zapytań znajdziesz w przewodniku po interfejsie Domain Shared Contacts API.

  1. Wysyła żądanie HTTP GET do adresu URL pliku danych z kontaktami z określonym parametrem:

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

    Zastąp następujące elementy:

    Aby na przykład pobrać wszystkie pozycje kontaktów współdzielonych w domenie example.com zaktualizowane po 16 marca 2022 r., wyślij żądanie HTTP do adresu URL pliku danych kontaktów współdzielonych w domenie i dodaj parametr updated-min do adresu URL żądania:

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

    Gdy wyślesz żądanie GET, serwer zwróci kod stanu HTTP 200 OK oraz plik danych zawierający wszystkie kontakty z domeny, które zostały utworzone lub zaktualizowane po podanej dacie.

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

Śledzenie zmian przyrostowych

Aby śledzić stopniowe zmiany na liście kontaktów udostępnionych w domenie: 1. Gdy wysyłasz żądanie pliku danych, śledź wartość elementu <updated> w tym pliku. 1. Aby pobrać tylko kontakty udostępnione w domenie, które zmieniły się od czasu poprzedniego żądania, ustaw parametr zapytania updated-min na wartość <updated>, a parametr showdeleted na true.

Pobieranie pojedynczego udostępnionego kontaktu

Aby uzyskać pojedynczy udostępniony kontakt, musisz użyć linku do tego kontaktu. Link do udostępnionego kontaktu możesz uzyskać tylko wtedy, gdy znajdziesz jego wpis w strumieniach udostępnionych kontaktów. Jeśli nie wiesz, jakiej wartości użyć w przypadku linku do siebie, zapoznaj się z artykułami Pobieranie wszystkich kontaktów i Pobieranie kontaktów za pomocą parametrów zapytań.

  1. Aby uzyskać informacje o konkretnym udostępnionym kontakcie w domenie, wyślij żądanie HTTP GETdo linku do tego kontaktu: 
    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/:SELF_LINK>
     Zastąp te elementy:
  • DOMAIN: adres URL Twojej domeny, np. example.com.
  • PROJECTION: wartość projekcji określająca elementy gd:extendedProperty. Listę obsługiwanych wartości znajdziesz w artykule Wartości projekcji.
  • SELF_LINK: unikalna wartość liczbowa reprezentująca pojedynczy udostępniony kontakt, np. 12345.

Następnie serwer zwraca kod stanu HTTP 200 OK i rekord zawierający kontakt.

Aby na przykład uzyskać kontakt udostępniony w domenie z ustawionym linkiem do siebie 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