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

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

    เซิร์ฟเวอร์ของ Google จะสร้างรายชื่อติดต่อโดยใช้ข้อมูลที่คุณส่งไป จากนั้นแสดงรหัสสถานะ HTTP 201 CREATED พร้อมกับสำเนาของรายชื่อติดต่อใหม่ในรูปแบบองค์ประกอบ <entry> รายการที่แสดงเป็นรายการเดียวกับที่คุณส่ง แต่ยังมีองค์ประกอบต่างๆ ที่เซิร์ฟเวอร์เพิ่มด้วย เช่น องค์ประกอบ <id>

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

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