หลังจากตั้งค่าการตรวจสอบสิทธิ์แล้ว คุณจะใช้ Domain Shared Contacts API เพื่อเผยแพร่รายชื่อติดต่อที่แชร์ใหม่ไปยังโดเมน Google Workspace ได้ รายชื่อติดต่อที่แชร์อาจใช้เวลาถึง 24 ชั่วโมงจึงจะปรากฏในการเติมข้อความอัตโนมัติ ในที่อยู่อีเมลและโปรแกรมจัดการรายชื่อติดต่อ
สร้างการนำเสนอ XML ของรายชื่อติดต่อที่แชร์ที่คุณต้องการเผยแพร่ในรูปแบบองค์ประกอบ Atom
<entry>
ของชนิดของรายชื่อติดต่อ ซึ่งอาจมีลักษณะคล้ายกับด้านล่างนี้<atom:entry xmlns:atom='http://www.w3.org/2005/Atom' xmlns:gd='http://schemas.google.com/g/2005'> <atom:category scheme='http://schemas.google.com/g/2005#kind' term='http://schemas.google.com/contact/2008#contact' /> <gd:name> <gd:givenName>FIRST_NAME</gd:givenName> <gd:familyName>LAST_NAME</gd:familyName> <gd:fullName>FIRST_NAME LAST_NAME</gd:fullName> </gd:name> <atom:content type='text'>NOTES</atom:content> <gd:email rel='http://schemas.google.com/g/2005#work' primary='true' address='PRIMARY_EMAIL_ADDRESS' displayName='PREFERRED_NAME' /> <gd:email rel='http://schemas.google.com/g/2005#home' address='SECONDARY_EMAIL_ADDRESS' /> <gd:phoneNumber rel='http://schemas.google.com/g/2005#work' primary='true'> PRIMARY_PHONE_NUMBER </gd:phoneNumber> <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'> SECONDARY_PHONE_NUMBER </gd:phoneNumber> <gd:im address='INSTANT_MESSAGING_ADDRESS' protocol='http://schemas.google.com/g/2005#GOOGLE_TALK' primary='true' rel='http://schemas.google.com/g/2005#home' /> <gd:structuredPostalAddress rel='http://schemas.google.com/g/2005#work' primary='true'> <gd:city>CITY_NAME</gd:city> <gd:street>ADDRESS</gd:street> <gd:region>REGION_NAME</gd:region> <gd:postcode>POST_CODE</gd:postcode> <gd:country>COUNTRY_NAME</gd:country> <gd:formattedAddress> FORMATTED_ADDRESS </gd:formattedAddress> </gd:structuredPostalAddress> </atom:entry>
แทนที่รายการต่อไปนี้
FIRST_NAME
: ชื่อของรายชื่อติดต่อที่แชร์ เช่น ธำรงLAST_NAME
: นามสกุลของผู้ติดต่อที่แชร์ เช่น คิมPRIMARY_EMAIL_ADDRESS
: อีเมลที่ต้องการของรายชื่อติดต่อที่แชร์ เช่น alk@gmail.comPREFERRED_NAME
: ชื่อที่แสดงแก่ผู้ใช้ เช่น Alex KimSECONDARY_EMAIL_ADDRESS
: อีเมลอื่นของรายชื่อติดต่อที่แชร์ เช่น alk@example.orgPRIMARY_PHONE_NUMBER
: หมายเลขโทรศัพท์ที่ต้องการใช้กับรายชื่อติดต่อที่แชร์ เช่น (800) 555-0100SECONDARY_PHONE_NUMBER
: หมายเลขโทรศัพท์อื่นของรายชื่อติดต่อที่แชร์ เช่น (800) 555-0101INSTANT_MESSAGING_ADDRESS
: อีเมลที่เชื่อมโยงกับข้อมูลการรับส่งข้อความโต้ตอบแบบทันทีของรายชื่อติดต่อที่แชร์ ตัวอย่างเช่น alk@gmail.comCITY_NAME
: ชื่อเมืองของผู้ติดต่อที่แชร์ เช่น Mountain ViewADDRESS
: ที่อยู่ของผู้ติดต่อที่แชร์ร่วมกัน เช่น 1600 Amphibious BlvdREGION_NAME
: รัฐหรือจังหวัดสำหรับ รายชื่อติดต่อที่แชร์ เช่น CAPOST_CODE
: รหัสไปรษณีย์สำหรับผู้ติดต่อที่แชร์ เช่น 94045COUNTRY_NAME
: ประเทศของผู้ติดต่อที่แชร์ เช่น สหรัฐอเมริกาFORMATTED_ADDRESS
: ที่อยู่ของรายชื่อติดต่อที่แชร์ซึ่งจัดรูปแบบตามแบบแผนของประเทศหรือภูมิภาค เช่น 1800 Amphibious Blvd Mountain View
หากต้องการเผยแพร่รายการนี้ ให้ส่งไปยัง URL ของฟีดรายชื่อติดต่อ:
- วางองค์ประกอบ Atom
<entry>
ในเนื้อหาของคําขอPOST
ใหม่โดยใช้ประเภทเนื้อหาapplication/atom+xml
- ส่งคำขอ
POST
ไปยัง URL ของฟีด
ตัวอย่างเช่น หากต้องการเพิ่มรายชื่อติดต่อที่แชร์ของโดเมนลงในรายการที่เป็นของ example.com ให้ส่งคำขอ
POST
พร้อมรายการใหม่ไปยัง URL ต่อไปนี้https://www.google.com/m8/feeds/contacts/example.com/full
เซิร์ฟเวอร์ของ Google จะสร้างรายชื่อติดต่อโดยใช้ข้อมูลที่คุณส่งไป จากนั้นแสดงรหัสสถานะ
HTTP 201 CREATED
พร้อมกับสำเนาของรายชื่อติดต่อใหม่ในรูปแบบองค์ประกอบ<entry>
รายการที่แสดงเป็นรายการเดียวกับที่คุณส่ง แต่ยังมีองค์ประกอบต่างๆ ที่เซิร์ฟเวอร์เพิ่มด้วย เช่น องค์ประกอบ<id>
หากคำขอของคุณไม่ประสบความสำเร็จ Google อาจแสดงรหัสสถานะอื่น หากต้องการข้อมูลเกี่ยวกับรหัสสถานะ โปรดดู เอกสารอ้างอิงโปรโตคอล Google Data API
- วางองค์ประกอบ Atom