Mendapatkan kontak bersama

Minta kontak pengguna bersama dengan cara berikut:

  • Semua kontak bersama
  • Sekumpulan kontak yang cocok dengan kriteria yang ditentukan
  • Satu kontak bersama
  • Foto untuk kontak

Secara default, entri dalam feed tidak berurutan.

Mendapatkan semua kontak bersama

  1. Untuk mendapatkan semua kontak bersama, kirim permintaan HTTP GET ke URL feed kontak:

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

    Ganti kode berikut:

    • DOMAIN: Domain Anda. Misalnya, example.com.
    • PROJECTION: Nilai proyeksi. Untuk nilai yang didukung, lihat Nilai proyeksi.

    Server menampilkan kode status HTTP 200 OK dan feed Atom 1.0. Contoh berikut menunjukkan feed kontak dengan satu entri:

    <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. Feed menampilkan maksimum 10 MB dalam satu respons. Untuk mendapatkan seluruh daftar, ikuti link Berikutnya berulang kali di feed yang ditampilkan.

Mendapatkan kontak bersama menggunakan parameter kueri

Meminta kontak yang cocok dengan kriteria tertentu, seperti kontak yang diperbarui setelah tanggal tertentu. Kueri teks lengkap dan pencarian alamat email tidak didukung. Untuk semua parameter kueri, lihat Panduan referensi Domain Shared Contacts API.

  1. Kirim permintaan HTTP GET ke URL feed kontak dengan parameter:

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

    Ganti kode berikut:

    Misalnya, untuk mendapatkan entri yang diperbarui setelah 16 Maret 2022 untuk example.com, tambahkan parameter updated-min:

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

    Server menampilkan kode status HTTP 200 OK dan feed dengan kecocokan apa pun.

  2. Feed menampilkan maksimum 10 MB dalam satu respons. Untuk mendapatkan seluruh daftar, ikuti link Berikutnya berulang kali di feed yang ditampilkan.

Melacak perubahan inkremental

Untuk melacak perubahan pada daftar kontak bersama domain: 1. Catat nilai elemen <updated> feed. 1. Minta kontak yang diubah dengan menyetel updated-min ke nilai <updated> tersebut dan menyetel showdeleted ke true.

Mendapatkan satu kontak bersama

Untuk mendapatkan kontak tertentu, gunakan link mandiri kontak, yang dapat Anda temukan di feed kontak bersama. Untuk mengetahui informasi selengkapnya, lihat Mendapatkan semua kontak bersama.

  1. Untuk mendapatkan kontak tertentu, kirim permintaan HTTP GET ke link self kontak: 
    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/SELF_LINK
     Ganti kode berikut:
  • DOMAIN: Domain Anda—misalnya, example.com.
  • PROJECTION: Nilai proyeksi. Untuk nilai yang didukung, lihat Nilai proyeksi.
  • SELF_LINK: Nilai numerik unik kontak.

Server menampilkan kode status HTTP 200 OK dan entri kontak.

Misalnya, untuk mendapatkan kontak dengan link mandiri https://www.google.com/m8/feeds/contacts/example.com/full/12345:

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

Langkah berikutnya