Panduan Migrasi Contacts API

Contacts API telah 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/tulis 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 Kontak Kolom Orang
atom:content biografi
atom:link rel='http://schemas.google.com/contacts/2008/rel#photo' foto
atom:title names
gContact:billingInformation miscKata Kunci (type=OUTLOOK_BILLING_INFORMATION)
gContact:ulang tahun ulang tahun
gContact:calendarLink calendarUrls
gContact:directoryServer kata kunci lain (type=OUTLOOK_DIRECTORY_SERVER)
gContact:peristiwa peristiwa
gContact:extendedProperty clientData
gContact:externalId externalIds
gContact:fileAs fileAses
gContact:gender gender
gContact:groupMembershipInfo memberships.contactGroupMembership
gContact:hobi minat
gContact:inisial Nama panggilan yang TIDAK DIGUNAKAN LAGI (type=INITIALS)
gContact:jot type='home' miscKeywords (type=HOME)
gContact:jot type='keywords' miscKata Kunci (type=OUTLOOK_KATA KUNCI)
gContact:jot type='other' miscKeywords (type=OTHER)
gContact:jot type='pengguna' miscKata kunci (type=OUTLOOK_USER)
gContact:jot type='work' miscKeywords (type=WORK)
gContact:language bahasa
gContact:namagadis Nama panggilan yang TIDAK DIGUNAKAN LAGI (type=MAIDEN_NAME)
gContact:jarak tempuh miscKata Kunci (type=OUTLOOK_MILEAGE)
gContact:nama panggilan nama panggilan (type=DEFAULT)
gContact:pekerjaan pekerjaan
gContact:prioritas kata kunci lain (type=OUTLOOK_PRIORITY)
gContact:relasi hubungan
gContact:sensitivitas miscKata kunci (type=OUTLOOK_SENSITIVITY)
gContact:shortName Nama panggilan yang TIDAK DIGUNAKAN LAGI (jenis=SHORT_NAME)
gContact:subjek kata kunci lain-lain (type=OUTLOOK_SUBJECT)
gContact:userDefinedField userDefined
gContact:situs urls
gContact:yomiName names.phonetic_full_name
gd:dihapus metadata.deleted
gd:email emailAddresses
gd:im imClients
gd:organisasi organizations
gd:phoneNumber phoneNumbers
gd:postalAddress addresses.formattedValue
gd:di mana hunian
gd:structuredPostalAddress 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 API Kontak Kolom Grup Kontak People API
atom:diperbarui metadata.updateTime
atom:title name
atom:content name
gd:dihapus metadata.deleted
systemGroup groupType=SYSTEM_CONTACT_GROUP

Endpoints

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. Artinya, 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 data "Kontak Lainnya" atau Direktori. Lihat detail di atas untuk cakupan yang diperlukan.

Untuk mengetahui detail selengkapnya, lihat Mengizinkan Permintaan.

Library klien