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

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 ควรระบุ API เวอร์ชัน 3.0 ดังนี้

GData-Version: 3.0

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