Domain Shared Contacts API ช่วยให้แอปพลิเคชันของคุณได้รับและอัปเดตรายชื่อติดต่อภายนอกที่แชร์กับผู้ใช้ทุกคนในโดเมน Google Workspace ได้ รายชื่อติดต่อที่แชร์จะปรากฏต่อผู้ใช้ทุกคนของโดเมน Google Workspace และบริการทั้งหมดของ Google จะมีสิทธิ์เข้าถึงรายชื่อติดต่อ
แอปพลิเคชันของคุณสามารถใช้ Domain Shared Contacts API เพื่อสร้างรายชื่อติดต่อที่แชร์ แก้ไข หรือลบรายชื่อติดต่อที่แชร์ที่มีอยู่ และค้นหารายชื่อติดต่อที่แชร์ซึ่งตรงกับเกณฑ์ที่เฉพาะเจาะจง
Domain Shared Contacts API ใช้ได้กับบัญชี Google Workspace เท่านั้น หากต้องการใช้ API ให้เปิดใช้ Domain Shared Contacts API ในคอนโซลผู้ดูแลระบบ การเปลี่ยนแปลงรายชื่อติดต่อที่แชร์อาจใช้เวลาถึง 24 ชั่วโมงจึงจะปรากฏในการเติมอีเมลอัตโนมัติและเครื่องมือจัดการรายชื่อติดต่อ
นอกจากข้อมูลเบื้องต้นเกี่ยวกับความสามารถของ Domain Shared Contacts API แล้ว เอกสารนี้ยังมีตัวอย่างเกี่ยวกับวิธีจัดการรายชื่อติดต่อโดยใช้ XML และ HTTP ด้วย หลังจากอ่านเอกสารนี้แล้ว คุณสามารถดูข้อมูลเพิ่มเติมเกี่ยวกับการโต้ตอบกับ API โดยใช้ไลบรารีของไคลเอ็นต์
ผู้ชม
เอกสารนี้มีไว้สำหรับนักพัฒนาซอฟต์แวร์ที่เขียนแอปพลิเคชันไคลเอ็นต์ซึ่งสามารถจัดการรายชื่อติดต่อของ Google โดยใช้ HTTP และ XML เอกสารนี้ถือว่าคุณเข้าใจพื้นฐานที่อยู่เบื้องหลังโปรโตคอล Google Data API
หากคุณใช้ระบบปฏิบัติการ UNIX และต้องการทำตามตัวอย่างในเอกสารนี้โดยไม่ต้องเขียนโค้ด ให้ใช้ยูทิลิตีบรรทัดคำสั่งของ UNIX อย่าง curl หรือ wget ดูวิธีใช้ cURL กับบริการข้อมูลของ Google
หลักการต่างๆ
Domain Shared Contacts API เวอร์ชันนี้เป็นไปตามหลักการของ Google Data API Google Data API อิงตามทั้งรูปแบบการเผยแพร่ Atom 1.0 และ RSS 2.0 นอกเหนือจากโปรโตคอลการเผยแพร่ Atom
ระบุเวอร์ชัน
คำขอทั้งหมดที่คุณส่งโดยใช้ Domain Shared Contacts API ควรระบุเวอร์ชัน 3.0 ของ API ดังนี้
GData-Version: 3.0
หากตั้งค่าส่วนหัว HTTP ไม่ได้ คุณสามารถระบุ v=3.0 เป็นส่วนหัวการค้นหาใน URL ได้ แต่เราขอแนะนำให้ใช้วิธีการระบุส่วนหัว HTTP