Mendapatkan kontak bersama

Anda dapat meminta kontak pengguna bersama dalam berbagai cara:

  • Semua kontak bersama
  • Sekumpulan kontak yang cocok dengan kriteria tertentu
  • Satu kontak bersama
  • Foto kontak

Secara default, entri dalam feed tidak diurutkan.

Dapatkan 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 hal berikut:

    • DOMAIN: URL untuk domain Anda—misalnya, example.com.
    • PROJECTION: Nilai proyeksi yang menentukan elemen gd:extendedProperty. Untuk daftar nilai yang didukung, lihat Nilai proyeksi.

    Feed akan menampilkan kode status HTTP 200 OK dan feed Atom 1.0 standar yang berisi kontak. Berikut adalah contoh feed kontak dengan hanya 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 tidak menampilkan lebih dari 10 MB dalam satu respons. Untuk mendapatkan seluruh daftar kontak, ikuti berulang kali link Berikutnya dari feed yang ditampilkan hingga Anda tidak lagi melihat link tersebut di feed kembali.

Mendapatkan kontak bersama menggunakan parameter kueri

Anda dapat meminta kumpulan kontak yang sesuai dengan kriteria yang ditentukan, seperti meminta kontak yang diperbarui setelah tanggal tertentu. Tidak ada dukungan untuk kueri teks lengkap atau mencari kontak melalui alamat email. Untuk mengetahui daftar lengkap parameter kueri yang didukung, lihat Panduan referensi API Kontak Bersama Domain.

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

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

    Ganti hal berikut:

    • DOMAIN: URL untuk domain Anda—misalnya, example.com.
    • PROJECTION: Nilai proyeksi yang menentukan elemen gd:extendedProperty. Untuk daftar nilai yang didukung, lihat Nilai proyeksi.
    • PARAMETER: Salah satu parameter kueri yang didukung. Untuk mengetahui informasi selengkapnya, lihat Panduan referensi API Kontak Bersama Domain.

    Misalnya, untuk memperbarui semua entri kontak bersama domain setelah 16 Maret 2022 untuk example.com, kirim permintaan HTTP ke URL feed kontak bersama domain dan tambahkan parameter updated-min ke URL permintaan:

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

    Saat Anda mengirim permintaan GET tersebut, server akan menampilkan kode status HTTP 200 OK dan feed yang berisi kontak bersama domain yang dibuat atau diperbarui setelah tanggal yang ditentukan.

  2. Feed tidak menampilkan lebih dari 10 MB dalam satu respons. Untuk mendapatkan seluruh daftar kontak dengan kriteria yang ditentukan, ikuti berulang kali link Berikutnya dari feed yang ditampilkan sampai Anda tidak lagi melihat link tersebut di feed kembali.

Melacak perubahan inkremental

Untuk melacak perubahan inkremental pada daftar kontak bersama domain, lakukan langkah berikut: 1. Saat Anda mengirim permintaan untuk feed, lacak nilai elemen <updated> feed. 1. Anda hanya bisa mendapatkan kontak bersama domain yang telah berubah sejak permintaan sebelumnya dengan menetapkan parameter kueri updated-min ke nilai <updated> tersebut, dan menetapkan showdeleted ke true.

Mendapatkan satu kontak bersama

Untuk mendapatkan satu kontak bersama, Anda harus menggunakan link mandiri kontak tersebut. Anda hanya bisa mendapatkan link mandiri kontak bersama dengan mencari entri kontak di feed kontak bersama. Jika Anda tidak yakin nilai yang akan digunakan untuk link mandiri, baca Mendapatkan semua kontak dan Mendapatkan kontak dengan menggunakan parameter kueri.

  1. Untuk mendapatkan kontak bersama domain tertentu, kirim permintaan GET HTTP ke link mandiri ke kontak: 
    GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/:SELF_LINK>
    Ganti kode berikut:
  • DOMAIN: URL untuk domain Anda—misalnya, example.com.
  • PROJECTION: Nilai proyeksi yang menentukan elemen gd:extendedProperty. Untuk daftar nilai yang didukung, lihat Nilai proyeksi.
  • SELF_LINK: Nilai numerik unik yang mewakili satu kontak bersama—misalnya, 12345.

Selanjutnya, server menampilkan kode status HTTP 200 OK dan entri yang berisi kontak.

Misalnya, untuk mendapatkan kontak bersama domain dengan link mandiri ditetapkan ke https://www.google.com/m8/feeds/contacts/example.com/full/12345, kirim permintaan HTTP berikut:

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

Langkah berikutnya