People API memungkinkan Anda:
- Membaca dan mengelola Kontak pengguna yang diautentikasi
- Membaca dan menyalin "Kontak lainnya" pengguna yang diautentikasi
- Membaca informasi profil untuk pengguna terautentikasi dan kontaknya
- Membaca kontak dan profil domain
Misalnya, pengguna terautentikasi, Jen, memiliki Fabian dan Ranjith di
kontak pribadinya. Saat aplikasi Anda memanggil
people.connections.list
untuk membaca
daftar koneksinya, Jen akan melihat layar izin yang meminta untuk memberi
aplikasi tersebut akses ke daftar. Jika Jen mengizinkan, aplikasi akan membaca daftar yang berisi
person resources
untuk Fabian dan Ranjith.
Jika aplikasi memerlukan informasi untuk orang tertentu, aplikasi kemudian dapat memanggil
people.get
, yang meneruskan nama resource, untuk mendapatkan
person resource
bagi orang tersebut.
Aplikasi juga dapat mengelola kontak dengan membuat kontak baru menggunakan
people.createContact
, memperbarui kontak
yang ada yang telah dibaca dari
people.connections.list
menggunakan
people.updateContact
, dan menghapus kontak
menggunakan people.deleteContact
.
Pengguna Google Workspace juga dapat mencantumkan profil domain direktori dan kontak
domain mereka menggunakan
people.listDirectoryPeople
atau menelusuri
mereka menggunakan
people.searchDirectoryPeople
.
Tampilan informasi orang yang digabungkan
Informasi orang yang dibaca People API digabungkan dari berbagai sumber, bergantung pada kondisi berikut:
Sumber | Kondisi |
---|---|
Data profil publik Google | Selalu. |
Data profil domain Google Workspace | Admin domain telah mengaktifkan berbagi kontak eksternal dan
profil
dengan data cakupan domain dan cakupan
directory.readonly telah
diberikan |
Informasi profil pribadi pengguna terautentikasi | Salah satu cakupan
profile
telah diberikan. |
Kontak pengguna terautentikasi | Cakupan
contacts telah
diberikan. |
Memahami Data Orang yang Digabungkan
Data untuk seseorang berasal dari satu jenis sumber utama. Data dari sumber lain digabungkan dengan data ini jika sumbernya terhubung melalui alamat email, nomor telepon, atau URL profil terverifikasi. Berikut adalah cara orang menyusun:
Sumber Utama | Kontak | Profil | Profil Domain Google Workspace | Kontak Domain Google Workspace | Penggunaan |
---|---|---|---|---|---|
Kontak | 1 | 0+ | 0+ | 0+ | Ditampilkan untuk sebagian besar endpoint |
Profil | 0+ | 1 | 0 atau 1 | 0 | Ditampilkan di people.get saat digunakan untuk mendapatkan orang tersebut untuk pengguna yang login atau mendapatkan seseorang untuk Akun Google pengguna lain. |
Kontak Domain | 0+ | 0 | 0 | 1 | Ditampilkan di people.listDirectoryPeople atau people.searchDirectoryPeople . |
Hanya kontak berbasis kontak yang dapat diubah oleh endpoint mutasi. Mutasi kontak dan profil domain tidak didukung.