Halaman ini diterjemahkan oleh Cloud Translation API.

Mendapatkan kontak bersama

Anda dapat meminta kontak pengguna bersama dengan berbagai cara:

Semua kontak bersama
Kumpulan kontak yang cocok dengan kriteria yang ditentukan
Satu kontak bersama
Foto untuk kontak

Secara default, entri dalam feed tidak diurutkan.

Mendapatkan semua kontak bersama

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

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

Ganti kode berikut:

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

Feed menampilkan kode status HTTP 200 OK dan feed Atom 1.0 standar yang berisi kontak. Berikut adalah contoh feed kontak yang hanya memiliki 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>

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

Mendapatkan kontak bersama menggunakan parameter kueri

Anda dapat meminta kumpulan kontak yang cocok dengan kriteria yang ditentukan, seperti meminta kontak yang diperbarui setelah tanggal tertentu. Tidak ada dukungan untuk kueri teks lengkap atau menemukan kontak berdasarkan alamat email. Untuk daftar lengkap parameter kueri yang didukung, lihat panduan referensi Domain Shared Contacts API.

Kirim permintaan HTTP GET ke URL feed kontak dengan parameter yang ditentukan:
```
GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION?PARAMETER
```
Ganti kode berikut:
- DOMAIN: URL untuk domain Anda—misalnya, example.com.
- PROJECTION: Nilai proyeksi yang menentukan elemen gd:extendedProperty. Untuk mengetahui daftar nilai yang didukung, lihat Nilai proyeksi.
- PARAMETER: Salah satu parameter kueri yang didukung. Untuk informasi selengkapnya, lihat Panduan referensi Domain Shared Contacts API.
Misalnya, untuk mendapatkan semua entri kontak bersama domain yang diperbarui 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.
Feed tidak menampilkan lebih dari 10 MB dalam satu respons. Untuk mendapatkan seluruh daftar kontak dengan kriteria yang ditentukan, ikuti berulang kali link Berikutnya feed yang ditampilkan hingga Anda tidak lagi melihat link tersebut di feed yang ditampilkan.

Melacak perubahan inkremental

Untuk melacak perubahan inkremental pada daftar kontak bersama domain, lakukan hal 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. Anda hanya dapat mendapatkan link mandiri kontak bersama dengan menemukan entri kontak di feed kontak bersama. Jika Anda tidak yakin dengan nilai yang akan digunakan untuk link mandiri, lihat Mendapatkan semua kontak dan Mendapatkan kontak menggunakan parameter kueri.

Untuk mendapatkan kontak bersama domain tertentu, kirim permintaan GET HTTP ke link mandiri 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 mengetahui daftar nilai yang didukung, lihat Nilai proyeksi.
SELF_LINK: Nilai numerik unik yang mewakili satu kontak bersama—misalnya, 12345.

Server kemudian menampilkan kode status HTTP 200 OK dan entri yang berisi kontak.

Misalnya, untuk mendapatkan kontak bersama domain dengan link mandiri yang 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

Mendapatkan foto untuk kontak bersama