Domain Shared Contacts API memungkinkan aplikasi mendapatkan dan memperbarui kontak eksternal yang dibagikan kepada semua pengguna di domain Google Workspace. Kontak bersama dapat dilihat 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 agar terlihat dalam pelengkapan otomatis dan pengelola kontak.
Dokumen ini menjelaskan 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 bagi developer yang menulis aplikasi klien yang memanipulasi daftar kontak Google menggunakan HTTP dan XML. Dokumen ini mengasumsikan pengetahuan tentang protokol Google Data API.
Pengguna Linux dan macOS dapat mencoba contoh dalam dokumen ini menggunakan curl atau wget. Lihat Menggunakan curl dengan Google Data API.
Prinsip
Domain Shared Contacts API mengikuti prinsip Google Data API. Google Data API 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 menyetel header HTTP, tentukan v=3.0 sebagai parameter kueri.
Metode header HTTP direkomendasikan.