ภาพรวม API รายชื่อติดต่อที่แชร์ของโดเมน

Domain Shared Contacts API ช่วยให้แอปพลิเคชันได้รับและอัปเดตรายชื่อติดต่อภายนอกที่แชร์กับผู้ใช้ทุกคนในโดเมน Google Workspace ได้ รายชื่อติดต่อที่แชร์จะปรากฏต่อผู้ใช้ทุกคนในโดเมน Google Workspace และบริการทั้งหมดของ Google จะมีสิทธิ์เข้าถึงรายชื่อติดต่อ

คำเตือน: Domain Shared Contacts API ใช้สำหรับรายชื่อติดต่อภายนอกเท่านั้น การใช้ API นี้เพื่อสร้างข้อมูลติดต่อสำหรับผู้ใช้ภายในหรือกลุ่มอาจทำให้ข้อมูลซ้ำกันและเกิดลักษณะการทำงานที่ไม่คาดคิด หากต้องการ จัดการข้อมูลติดต่อของผู้ใช้ภายในของ Google Workspace ให้ใช้ Directory API

ใช้ Domain Shared Contacts API เพื่อสร้าง แก้ไข หรือลบรายชื่อติดต่อที่แชร์ และค้นหารายชื่อติดต่อที่ตรงกับเกณฑ์ที่เฉพาะเจาะจง

Domain Shared Contacts API ใช้ได้กับบัญชี Google Workspace เท่านั้น หากต้องการใช้ API ให้ เปิดใช้ Domain Shared Contacts API ในคอนโซลผู้ดูแลระบบ การเปลี่ยนแปลงอาจใช้เวลาถึง 24 ชั่วโมงจึงจะแสดงในการเติมข้อความอัตโนมัติและ เครื่องมือจัดการรายชื่อติดต่อ

เอกสารนี้จะอธิบายเบื้องหลังของ Domain Shared Contacts API และตัวอย่าง สำหรับการจัดการรายชื่อติดต่อโดยใช้ XML และ HTTP ดูข้อมูลเพิ่มเติมได้ที่ไลบรารีของไคลเอ็นต์

กลุ่มเป้าหมาย

เอกสารนี้มีไว้สำหรับนักพัฒนาซอฟต์แวร์ที่เขียนแอปพลิเคชันไคลเอ็นต์ซึ่ง จัดการรายชื่อติดต่อ Google โดยใช้ HTTP และ XML โดยจะถือว่าคุณมีความรู้เกี่ยวกับโปรโตคอล Google Data APIs

ผู้ใช้ Linux และ macOS สามารถลองใช้ตัวอย่างในเอกสารนี้โดยใช้ curl หรือ wget ดูใช้ curl กับ Google Data APIs

AI

Domain Shared Contacts API เป็นไปตามหลักการของ Google Data APIs Google Data API อิงตาม Atom 1.0, RSS 2.0 และ Atom Publishing Protocol

ระบุเวอร์ชัน

คำขอทั้งหมดที่ส่งโดยใช้ Domain Shared Contacts API ควรระบุเวอร์ชัน 3.0 ดังนี้

GData-Version: 3.0

หากตั้งค่าส่วนหัว HTTP ไม่ได้ ให้ระบุ v=3.0 เป็นพารามิเตอร์การค้นหา เราขอแนะนำให้ใช้วิธีส่วนหัว HTTP

หมายเหตุ: ไลบรารีของไคลเอ็นต์จะระบุส่วนหัวของเวอร์ชันโดยอัตโนมัติ อย่าใช้พารามิเตอร์ v=3.0 กับไลบรารีของไคลเอ็นต์