สร้างรายชื่อติดต่อที่แชร์

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

1. สร้างการแสดง XML ของรายชื่อติดต่อที่แชร์ซึ่งคุณต้องการเผยแพร่ในรูปแบบองค์ประกอบ <entry> ของ Atom ประเภทรายชื่อติดต่อ ซึ่งอาจมีลักษณะคล้ายกับตัวอย่างต่อไปนี้

   <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: ชื่อนามสกุลของรายชื่อติดต่อที่แชร์ เช่น Alex
   • LAST_NAME: นามสกุลของรายชื่อติดต่อที่แชร์ เช่น Kim
   • PRIMARY_EMAIL_ADDRESS: อีเมลที่ต้องการสำหรับรายชื่อติดต่อที่แชร์ เช่น [e-mail]
   • PREFERRED_NAME: ชื่อที่แสดงสำหรับผู้ใช้ เช่น Alex Kim
   • SECONDARY_EMAIL_ADDRESS: อีเมลอื่นสำหรับรายชื่อติดต่อที่แชร์ เช่น [e-mail]
   • PRIMARY_PHONE_NUMBER: หมายเลขโทรศัพท์ที่ต้องการสำหรับรายชื่อติดต่อที่แชร์ เช่น [phone]
   • SECONDARY_PHONE_NUMBER: หมายเลขโทรศัพท์อื่นสำหรับรายชื่อติดต่อที่แชร์ เช่น [phone]
   • INSTANT_MESSAGING_ADDRESS: อีเมลที่เชื่อมโยงกับข้อมูลการรับส่งข้อความทันทีของรายชื่อติดต่อที่แชร์ เช่น [e-mail]
   • CITY_NAME: ชื่อเมืองของรายชื่อติดต่อที่แชร์ เช่น ภูเก็ต
   • ADDRESS: ที่อยู่สำหรับติดต่อที่ใช้ร่วมกัน เช่น 1600 Amphibious Blvd.
   • REGION_NAME: รัฐหรือจังหวัดของรายชื่อติดต่อที่แชร์ เช่น CA
   • POST_CODE: รหัสไปรษณีย์ของรายชื่อติดต่อที่แชร์ เช่น 94045
   • COUNTRY_NAME: ประเทศของรายชื่อติดต่อที่แชร์ เช่น สหรัฐอเมริกา
   • FORMATTED_ADDRESS: ที่อยู่ของรายชื่อติดต่อที่แชร์ซึ่งจัดรูปแบบโดยใช้รูปแบบของประเทศหรือภูมิภาค เช่น 1800 Amphibious Blvd Mountain View

2. หากต้องการเผยแพร่รายการนี้ ให้ส่งไปยัง URL ของฟีดรายชื่อติดต่อ ดังนี้

   1. วางองค์ประกอบ <entry> ของ Atom ในเนื้อหาของPOSTคำขอใหม่โดยใช้ประเภทเนื้อหา application/atom+xml
   2. ส่งคําขอ 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

ขั้นตอนถัดไป

• อัปเดตหรือลบรูปภาพสำหรับรายชื่อติดต่อที่แชร์