Menampilkan daftar semua "Kontak lainnya", yaitu kontak yang tidak ada dalam grup kontak. "Kontak lainnya" biasanya merupakan kontak yang dibuat secara otomatis dari interaksi.
Masa berlaku token sinkronisasi berakhir 7 hari setelah sinkronisasi penuh. Permintaan dengan token sinkronisasi yang sudah tidak berlaku akan menerima error dengan google.rpc.ErrorInfo dengan alasan "EXPIRED_SYNC_TOKEN". Jika terjadi error seperti itu, klien harus membuat permintaan sinkronisasi penuh tanpa
.syncToken
Halaman pertama dari permintaan sinkronisasi penuh memiliki kuota tambahan. Jika kuota terlampaui, error 429 akan ditampilkan. Kuota ini bersifat tetap dan tidak dapat ditambah.
Saat
ditentukan, resource yang dihapus sejak sinkronisasi terakhir akan ditampilkan sebagai pengguna dengan syncToken
disetel ke benar (true).PersonMetadata.deleted
Saat
atau pageToken
ditentukan, semua parameter permintaan lainnya harus cocok dengan panggilan pertama.syncToken
Operasi tulis mungkin mengalami penundaan penerapan selama beberapa menit untuk permintaan sinkronisasi. Sinkronisasi inkremental tidak dimaksudkan untuk kasus penggunaan baca setelah tulis.
Lihat contoh penggunaan di Menampilkan daftar kontak lainnya milik pengguna yang telah berubah.
Permintaan HTTP
GET https://people.googleapis.com/v1/otherContacts
URL menggunakan sintaksis gRPC Transcoding.
Parameter kueri
Parameter | |
---|---|
pageToken |
Opsional. Token halaman, diterima dari respons sebelumnya Saat melakukan penomoran halaman, semua parameter lain yang disediakan ke |
pageSize |
Opsional. Jumlah "Kontak lainnya" yang akan disertakan dalam respons. Nilai yang valid adalah antara 1 dan 1000, inklusif. Jika tidak disetel atau disetel ke 0, defaultnya adalah 100. |
requestSyncToken |
Opsional. Apakah respons harus menampilkan Detail selengkapnya tentang perilaku sinkronisasi di |
syncToken |
Opsional. Token sinkronisasi, diterima dari respons sebelumnya Saat menyinkronkan, semua parameter lain yang disediakan ke Detail selengkapnya tentang perilaku sinkronisasi di |
readMask |
Wajib. Mask kolom untuk membatasi kolom mana pada setiap orang yang ditampilkan. Beberapa kolom dapat ditentukan dengan memisahkannya menggunakan koma. Nilai yang valid bergantung pada ReadSourceType yang digunakan. Jika READ_SOURCE_TYPE_CONTACT digunakan, nilai yang valid adalah:
Jika READ_SOURCE_TYPE_PROFILE digunakan, nilai yang valid adalah:
|
sources[] |
Opsional. Mask untuk jenis sumber yang akan ditampilkan. Jika tidak disetel, setelan defaultnya adalah Nilai yang memungkinkan untuk kolom ini adalah: Penentuan |
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Respons terhadap permintaan untuk "Kontak lainnya" milik pengguna terautentikasi.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"otherContacts": [
{
object ( |
Kolom | |
---|---|
otherContacts[] |
Daftar "Kontak lainnya" ditampilkan sebagai resource Person. "Kontak lainnya" mendukung subkumpulan kolom yang terbatas. Lihat ListOtherContactsRequest.request_mask untuk informasi lebih detail. |
nextPageToken |
Token, yang dapat dikirim sebagai |
nextSyncToken |
Token yang dapat dikirim sebagai |
totalSize |
Jumlah total kontak lain dalam daftar tanpa penomoran halaman. |
Cakupan otorisasi
Memerlukan cakupan OAuth berikut ini:
https://www.googleapis.com/auth/contacts.other.readonly
Untuk informasi selengkapnya, lihat Panduan otorisasi.