Tạo người liên hệ được chia sẻ

Sau khi thiết lập phương thức xác thực, bạn có thể sử dụng Domain Shared Contacts API để xuất bản các mục liên hệ được chia sẻ mới lên một miền Google Workspace. Người liên hệ được chia sẻ có thể mất tới 24 giờ để xuất hiện trong tính năng tự động hoàn thành địa chỉ email và trình quản lý danh bạ.

  1. Tạo bản trình bày XML của người liên hệ được chia sẻ mà bạn muốn phát hành dưới dạng phần tử Atom <entry> của Loại liên hệ, có thể có dạng như sau:

    <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>

    Thay thế đoạn mã sau:

    • FIRST_NAME: Tên của người liên hệ dùng chung, ví dụ: Alex.
    • LAST_NAME: Họ của người liên hệ dùng chung – ví dụ: Kim.
    • PRIMARY_EMAIL_ADDRESS: Địa chỉ email ưu tiên của người liên hệ được chia sẻ, ví dụ: alk@gmail.com.
    • PREFERRED_NAME: Tên hiển thị cho người dùng – ví dụ: Alex Kim
    • SECONDARY_EMAIL_ADDRESS: Địa chỉ email khác cho người liên hệ dùng chung, ví dụ: alk@example.org.
    • PRIMARY_PHONE_NUMBER: Số điện thoại ưu tiên cho người liên hệ được chia sẻ – ví dụ: (800) 555-0100.
    • SECONDARY_PHONE_NUMBER: Một số điện thoại khác của người liên hệ được chia sẻ – ví dụ: (800) 555-0101.
    • INSTANT_MESSAGING_ADDRESS: Địa chỉ email liên kết với thông tin nhắn tin nhanh của người liên hệ được chia sẻ, ví dụ: alk@gmail.com.
    • CITY_NAME: Tên thành phố của người liên hệ được chia sẻ, ví dụ: Mountain View.
    • ADDRESS: Địa chỉ đường phố của người liên hệ được chia sẻ – ví dụ: 1600 Amphibious Blvd.
    • REGION_NAME: Tiểu bang hoặc tỉnh của người liên hệ được chia sẻ – ví dụ: CA.
    • POST_CODE: Mã ZIP hoặc mã bưu chính của người liên hệ được chia sẻ — ví dụ: 94045.
    • COUNTRY_NAME: Quốc gia của thông tin liên hệ được chia sẻ – ví dụ: Hoa Kỳ.
    • FORMATTED_ADDRESS: Địa chỉ của người liên hệ dùng chung được định dạng theo quy ước của quốc gia hoặc khu vực của họ,ví dụ: 1800 Amphibious Blvd Mountain View.

  2. Để xuất bản mục này, hãy gửi mục nhập tới URL của nguồn cấp dữ liệu danh sách liên hệ:

    1. Đặt phần tử Atom <entry> của bạn vào phần nội dung của yêu cầu POST mới bằng cách sử dụng loại nội dung application/atom+xml.
    2. Gửi yêu cầu POST đến URL nguồn cấp dữ liệu.

    Ví dụ: để thêm một người liên hệ được chia sẻ trên miền vào danh sách thuộc về example.com, hãy gửi yêu cầu POST có mục nhập mới đến URL sau:

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

    Máy chủ của Google tạo một mục liên hệ bằng cách sử dụng mục nhập mà bạn đã gửi, sau đó trả về mã trạng thái HTTP 201 CREATED, cùng với bản sao của mục liên hệ mới ở dạng phần tử <entry>. Mục nhập được trả về giống với mục mà bạn đã gửi, nhưng cũng chứa nhiều phần tử do máy chủ thêm vào, chẳng hạn như phần tử <id>.

    Nếu yêu cầu của bạn không thành công, Google có thể trả về một mã trạng thái khác. Để biết thông tin về các mã trạng thái, hãy xem tài liệu tham khảo về giao thức Google Data API.

Các bước tiếp theo