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

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

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

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

   1. วางองค์ประกอบ Atom <entry> ในเนื้อหาของคำขอ POST ใหม่โดยใช้ประเภทเนื้อหา application/atom+xml
   2. ส่งคำขอ POST ไปยัง URL ของฟีด

   ตัวอย่างเช่น หากต้องการเพิ่มรายชื่อติดต่อลงในรายการ example.com ให้ส่งPOST คำขอไปยัง URL ต่อไปนี้

   https://www.google.com/m8/feeds/contacts/example.com/full
   

   เซิร์ฟเวอร์จะสร้างรายชื่อติดต่อและแสดงรหัสสถานะ HTTP 201 CREATED พร้อมกับรายการรายชื่อติดต่อใหม่ รายการที่แสดงประกอบด้วยองค์ประกอบที่สร้างขึ้นจากเซิร์ฟเวอร์ เช่น <id>

   หากคำขอไม่สำเร็จ เซิร์ฟเวอร์จะแสดงรหัสสถานะอื่น ดูข้อมูลอ้างอิงโปรโตคอล Google Data API

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

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