Panduan Migrasi Contacts API

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Contacts API dinonaktifkan pada 19 Januari 2022. Gunakan panduan ini untuk mempelajari perubahan pada kolom, endpoint, dan cakupan otorisasi saat Anda bermigrasi ke People API.

Ringkasan

People API memiliki fungsi yang sama dengan Contacts API lama untuk semua fitur, dengan pengecualian berikut untuk Kontak Lainnya:

  • Administrator memiliki izin hanya baca untuk "Kontak Lainnya" melalui cakupan baru. Karena mengirim sinyal mutasi/penulisan kembali ke "Kontak Lainnya" tidak didukung, pengguna Anda harus menambahkan Kontak Lainnya sebagai Kontak Saya jika ingin memperbarui kolom datanya.

  • Hanya informasi kontak dasar untuk "Kontak Lainnya" yang dapat dibaca melalui API. Misalnya, nama lengkap, alamat email, dan nomor telepon.

Selain itu, cakupan Kontak lama (https://www.google.com/m8/feeds), yang memberikan akses ke kontak pribadi dan informasi direktori, diganti dengan cakupan berikut:

  • Untuk mengakses kontak pribadi: https://www.googleapis.com/auth/contacts
  • Untuk mengakses informasi direktori: https://www.googleapis.com/auth/directory.readonly

Kontak

Pemetaan Kolom

Kolom Contact Kolom Orang
atom:konten biografi
atom:link rel='http://schemas.google.com/contacts/2008/rel#photo' foto
atom:judul nama
gContact:penagihanInformasi miscKeywords (jenis=OUTLOOK_ pemakaian_INFORMATION)
gContact:ulang tahun ulang tahun
gContact:linkLink Urlkalender
gContact:direktoriServer miscKata kunci (type=OUTLOOK_DIRECTORY_SERVER)
gContact:acara peristiwa
gContact:extendedProperty dataklien
gContact:ID eksternal ID eksternal
gContact:fileAs fileAses
gContact:gender gender
gContact:grupKeanggotaanInfo memberships.contactGroupMembership
gContact:hobi minat
gContact:inisial Nama panggilan TIDAK DIGUNAKAN LAGI (type=INITIALS)
gContact:jot type='home' miscKata kunci (type=HOME)
gContact:jot type='keywords' miscKata kunci (type=OUTLOOK_KATA KUNCI)
gContact:jot type='other' miscKata kunci (jenis=OTHER)
gContact:jot type='user' miscKata kunci (type=OUTLOOK_USER)
gContact:jot type='work' miscKata kunci (type=WORK)
gContact:bahasa bahasa
gContact:namamaiden Nama panggilan TIDAK DIGUNAKAN LAGI (type=MAIDEN_NAME)
gContact:jarak tempuh miscKeywords (jenis=OUTLOOK_MILEAGE)
gContact:namapanggilan nama panggilan (type=DEFAULT)
gContact:pekerjaan pekerjaan
gContact:prioritas miscKata kunci (type=OUTLOOK_PRIORITY)
gContact:hubungan relasi
gContact:sensitivitas miscKata kunci (type=OUTLOOK_SENSITIVITY)
gContact:Nama pendek Nama panggilan TIDAK DIGUNAKAN LAGI (type=SHORT_NAME)
gContact:subjek miscKata kunci (type=OUTLOOK_SUBJECT)
gContact:userDefinisidField Ditentukan pengguna
gContact:situs URL
gContact:yomiName name.phonetic_full_name
gd:dihapus metadata.dihapus
email:gd alamatEmail
gd:im imClients
gd:organisasi organisasi
gd:nomor telepon phoneNumbers
gd:alamatAlamat addresses.formattedValue
gd.di mana tempat tinggal
gd:StructuredAddressAddress alamat

Endpoint Kontak Pribadi

Dibaca

Memerlukan cakupan https://www.googleapis.com/auth/contacts atau https://www.googleapis.com/auth/contacts.readonly.

Mutasi

Memerlukan cakupan https://www.googleapis.com/auth/contacts. Mengubah semua kolom kontak, kecuali foto.

Mutasi Foto

Memerlukan cakupan https://www.googleapis.com/auth/contacts.

Endpoint Kontak Lainnya

Dibaca

Kontak lainnya bersifat hanya baca dan hanya kolom names, emailAddresses, dan phoneNumbers yang ditampilkan.

Memerlukan cakupan https://www.googleapis.com/auth/contacts.other.readonly.

Salin

Memerlukan cakupan https://www.googleapis.com/auth/contacts.other.readonly dan https://www.googleapis.com/auth/contacts.

Endpoint Daftar Alamat Global

Memerlukan cakupan https://www.googleapis.com/auth/directory.readonly.

Grup Kontak

Pemetaan Kolom

Kolom Grup Kontak Contacts API Kolom Grup Kontak People API
atom:diupdate metadata.updateTime
atom:judul name
atom:konten name
gd:dihapus metadata.dihapus
grupgrup grupJenis=SYSTEM_CONTACT_GROUP

Endpoint

Dibaca

Memerlukan cakupan https://www.googleapis.com/auth/contacts atau https://www.googleapis.com/auth/contacts.readonly.

Mutasi

Memerlukan cakupan https://www.googleapis.com/auth/contacts.

Cakupan otorisasi

Cakupan lama https://www.google.com/m8/feeds adalah alias untuk cakupan https://www.googleapis.com/auth/contacts. Ini berarti bahwa pemberian oauth yang ada dengan cakupan lama akan berfungsi untuk endpoint apa pun di People API yang memerlukan cakupan https://www.googleapis.com/auth/contacts. Membaca dan menulis kontak serta grup kontak akan berfungsi dengan cakupan lama.

People API memerlukan cakupan baru untuk mengakses "Kontak Lainnya" atau data Direktori. Lihat detail di atas untuk cakupan yang diperlukan.

Untuk mengetahui detail selengkapnya, lihat Mengizinkan Permintaan.

Library klien