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.
- Membaca satu kontak tertentu
people.get - Membaca beberapa kontak spesifik
people.getBatchGet - Membaca kontak menggunakan
people.connections.list
Mutasi
Memerlukan cakupan https://www.googleapis.com/auth/contacts. Mengubah semua kolom
kontak kecuali foto.
- Buat kontak menggunakan
people.createContact - Memperbarui kontak
yang ada menggunakan
people.updateContact - Hapus kontak
menggunakan
people.deleteContact.
Mutasi Foto
Memerlukan cakupan https://www.googleapis.com/auth/contacts.
- Perbarui foto kontak menggunakan
people.updateContactPhoto. - Hapus foto kontak menggunakan
people.deleteContactPhoto.
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.
- Membaca kontak lain menggunakan
otherContacts.list.
Salin
Memerlukan cakupan https://www.googleapis.com/auth/contacts.other.readonly dan https://www.googleapis.com/auth/contacts.
- Salin kontak lainnya menggunakan
otherContacts.copyOtherContactToMyContactsGroup.
Endpoint Daftar Alamat Global
Memerlukan cakupan https://www.googleapis.com/auth/directory.readonly.
- Mencantumkan semua kontak dan profil direktori
people.listDirectoryPeople. - Telusuri kontak dan profil direktori
people.searchDirectoryPeople.
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.
- Mendapatkan grup kontak tertentu menggunakan
people.contactGroups.get - Mencantumkan grup kontak menggunakan
people.contactGroups.list
Mutasi
Memerlukan cakupan https://www.googleapis.com/auth/contacts.
- Buat grup kontak menggunakan
people.contactGroups.create - Memperbarui grup kontak menggunakan
people.contactGroups.update - Menghapus grup kontak menggunakan
people.contactGroups.delete Menambahkan atau menghapus kontak dari grup kontak menggunakan
people.contactGroups.members.modify
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
- Untuk Apps Script, lihat Layanan Orang Lanjutan.
- Untuk bahasa lain yang didukung, lihat Menginstal Library Klien.