Penting: Migrasikan skrip Anda dari layanan Kontak ke layanan lanjutan People API sebelum Apps Script menonaktifkan layanan Kontak pada Maret 2023.
Apps Script tidak lagi menggunakan layanan Kontak pada 16 Desember 2022. Sebagai gantinya, gunakan layanan lanjutan People API. People API menggunakan protokol JSON yang lebih baru dan menyediakan fitur lanjutan, seperti menggabungkan kontak dengan profil.
Gunakan panduan ini untuk mempelajari metode layanan Kontak mana yang tidak memiliki padanan di layanan lanjutan People API, mempelajari apa yang dapat Anda gunakan, dan menemukan contoh kode untuk memigrasikan tugas umum. Untuk informasi selengkapnya, lihat Panduan Migrasi Contacts API.
Metode tanpa padanan People API
Berikut ini daftar metode getContacts
di layanan Kontak yang tidak
memiliki cara yang setara untuk menelusuri kontak di layanan lanjutan People API. Dengan
layanan lanjutan People API, Anda dapat menelusuri berdasarkan kolom names
,
nickNames
, emailAddresses
, phoneNumbers
, dan organizations
kontak yang
berasal dari sumber CONTACT
.
Metode tanpa padanan |
---|
|
Daftar berikut mencantumkan metode getContacts
dari layanan Kontak yang menggunakan parameter
label
tambahan. Anda dapat menggunakan searchContacts
dari layanan lanjutan People API untuk mendapatkan kontak berdasarkan kolom yang setara,
tetapi Anda tidak dapat membatasi penelusuran ke label tertentu.
Metode dengan Padanan Sebagian |
---|
|
Fitur tambahan yang tersedia dengan People API
Ketika bermigrasi ke layanan tingkat lanjut People API, Anda dapat mengakses fitur People API berikut yang tidak tersedia di layanan Kontak:
- Tentukan sumber data–Saat menelusuri informasi tentang seseorang, Anda dapat menentukan tempat untuk menelusurinya, seperti kontak Google atau profil Google.
- Telusuri orang berdasarkan string kueri–Anda dapat memperoleh daftar profil dan kontak yang cocok dengan string tertentu.
- Permintaan batch–Anda dapat mengelompokkan panggilan People API untuk membantu mengurangi waktu eksekusi skrip Anda.
Contoh kode untuk tugas umum
Bagian ini mencantumkan tugas-tugas umum dari layanan Kontak. Contoh kode ini menunjukkan cara membuat tugas menggunakan layanan lanjutan People API.
Mendapatkan grup kontak berdasarkan nama
Contoh kode berikut menunjukkan cara mendapatkan grup kontak berdasarkan namanya, yang
setara dengan getContactGroup(name)
dalam layanan Kontak.
Mendapatkan kontak melalui alamat email
Contoh kode berikut menunjukkan cara mendapatkan kontak berdasarkan alamat emailnya,
yang setara dengan getContact(emailAddress)
di layanan Kontak.
Dapatkan semua kontak
Contoh kode berikut menunjukkan cara mendapatkan semua kontak pengguna, yang
setara dengan getContacts()
dalam layanan Kontak.
Mendapatkan nama lengkap kontak
Contoh kode berikut menunjukkan cara mendapatkan nama lengkap kontak, yang
setara dengan getFullName()
dalam layanan Kontak.
Mendapatkan semua nomor telepon untuk kontak
Contoh kode berikut menunjukkan cara mendapatkan semua nomor telepon untuk sebuah kontak, yang setara dengan getPhones()
di layanan Kontak.
Mendapatkan nomor telepon tertentu untuk kontak
Contoh kode berikut menunjukkan cara mendapatkan nomor telepon tertentu untuk kontak, yang setara dengan getPhoneNumber()
dalam layanan Kontak.