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.
- Membaca satu kontak tertentu
people.get - Membaca beberapa kontak tertentu
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 lain menggunakan
otherContacts.copyOtherContactToMyContactsGroup.
Endpoint Daftar Alamat Global
Memerlukan cakupan https://www.googleapis.com/auth/directory.readonly.
- Cantumkan semua kontak dan profil direktori
people.listDirectoryPeople. - Telusuri kontak dan profil direktori
people.searchDirectoryPeople.
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.
- Mendapatkan grup kontak tertentu menggunakan
people.contactGroups.get - Membuat daftar 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 - Hapus 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. 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
- Untuk Apps Script, lihat Layanan Orang Lanjutan.
- Untuk bahasa lain yang didukung, lihat Menginstal Library Klien.