Domain Shared Contacts API memungkinkan aplikasi mendapatkan dan memperbarui kontak eksternal yang dibagikan kepada semua pengguna di domain Google Workspace. Kontak bersama terlihat oleh semua pengguna domain Google Workspace dan semua layanan Google memiliki akses ke daftar kontak.
Gunakan Domain Shared Contacts API untuk membuat, mengedit, atau menghapus kontak bersama, dan membuat kueri untuk kontak yang cocok dengan kriteria tertentu.
Domain Shared Contacts API hanya tersedia untuk akun Google Workspace. Untuk menggunakan API, aktifkan Domain Shared Contacts API di konsol Admin. Perubahan dapat memerlukan waktu hingga 24 jam untuk ditampilkan di pelengkapan otomatis dan pengelola kontak.
Dokumen ini berisi latar belakang Domain Shared Contacts API dan contoh untuk mengelola kontak menggunakan XML dan HTTP. Untuk mempelajari lebih lanjut, lihat library klien.
Audiens
Dokumen ini ditujukan untuk developer yang menulis aplikasi klien yang memanipulasi daftar kontak Google menggunakan HTTP dan XML. Dokumen ini mengasumsikan pengetahuan tentang protokol Google Data APIs.
Pengguna Linux dan macOS dapat mencoba contoh dalam dokumen ini menggunakan curl atau wget. Lihat Menggunakan curl dengan Google Data APIs.
Prinsip
Domain Shared Contacts API mengikuti prinsip Google Data APIs. Google Data APIs didasarkan pada Atom 1.0, RSS 2.0, dan Atom Publishing Protocol.
Menentukan versi
Semua permintaan yang dikirim menggunakan Domain Shared Contacts API harus menentukan versi 3.0:
GData-Version: 3.0
Jika Anda tidak dapat menetapkan header HTTP, tentukan v=3.0 sebagai parameter kueri.
Metode header HTTP direkomendasikan.