Domain Shared Contacts API memungkinkan aplikasi Anda 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.
Aplikasi Anda dapat menggunakan Domain Shared Contacts API untuk membuat kontak bersama, mengedit atau menghapus kontak bersama yang ada, dan membuat kueri untuk kontak bersama 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 kontak bersama dapat memerlukan waktu hingga 24 jam agar terlihat dalam pelengkapan otomatis alamat email dan pengelola kontak.
Selain memberikan latar belakang tentang kemampuan Domain Shared Contacts API, dokumen ini menawarkan contoh tentang cara mengelola kontak menggunakan XML dan HTTP. Setelah membaca dokumen ini, Anda dapat mempelajari lebih lanjut cara berinteraksi dengan API menggunakan library klien kami.
Audiens
Dokumen ini ditujukan bagi developer yang ingin menulis aplikasi klien yang dapat memanipulasi daftar kontak Google menggunakan HTTP dan XML. Dokumen ini mengasumsikan bahwa Anda memahami dasar-dasar di balik protokol Google Data API.
Jika Anda menggunakan sistem operasi UNIX dan ingin mencoba contoh dalam dokumen ini tanpa menulis kode apa pun, gunakan utilitas command line UNIX curl atau wget. Pelajari cara menggunakan cURL dengan layanan Data Google.
Prinsip
Versi Domain Shared Contacts API ini mengikuti prinsip-prinsip Google Data API. Google Data API didasarkan pada format distribusi Atom 1.0 dan RSS 2.0 selain Atom Publishing Protocol.
Menentukan versi
Setiap permintaan yang Anda kirim menggunakan Domain Shared Contacts API harus menentukan API versi 3.0:
GData-Version: 3.0
Jika tidak dapat menetapkan header HTTP, Anda dapat menentukanv=3.0 sebagai parameter kueri di
URL, tetapi metode header HTTP direkomendasikan.