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

Sau khi thiết lập quy trình xác thực, hãy dùng Domain Shared Contacts API để xuất bản các mục danh bạ dùng chung mới vào một miền Google Workspace. Danh bạ dùng chung có thể mất đến 24 giờ để xuất hiện trong tính năng tự động hoàn thành và Trình quản lý danh bạ.

  1. Tạo một bản biểu diễn XML của người liên hệ Được chia sẻ để xuất bản dưới dạng phần tử <entry> Atom của loại Người liên hệ:

    <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ế nội dung sau:

    • FIRST_NAME: Tên của người liên hệ, chẳng hạn như Dana.
    • LAST_NAME: Họ của người liên hệ, chẳng hạn như A.
    • PRIMARY_EMAIL_ADDRESS: Địa chỉ email ưu tiên, chẳng hạn như dana@example.com.
    • PREFERRED_NAME: Tên hiển thị của người dùng, chẳng hạn như Dana A.
    • SECONDARY_EMAIL_ADDRESS: Email phụ, chẳng hạn như da@example.com.
    • PRIMARY_PHONE_NUMBER: Số điện thoại ưu tiên, chẳng hạn như 800-555-0100.
    • SECONDARY_PHONE_NUMBER: Số điện thoại phụ, chẳng hạn như 800-555-0101.
    • INSTANT_MESSAGING_ADDRESS: Địa chỉ email của dịch vụ nhắn tin tức thời, chẳng hạn như dana@example.com.
    • CITY_NAME: Tên thành phố, chẳng hạn như Mountain View.
    • ADDRESS: Địa chỉ đường phố, chẳng hạn như 1800 Amphibious Blvd.
    • REGION_NAME: Tiểu bang hoặc tỉnh, chẳng hạn như California.
    • POST_CODE: Mã ZIP hoặc mã bưu chính, chẳng hạn như 94045.
    • COUNTRY_NAME: Quốc gia, chẳng hạn như Hoa Kỳ.
    • FORMATTED_ADDRESS: Địa chỉ được định dạng theo quy ước địa phương, chẳng hạn như 1800 Amphibious Blvd., Mountain View, CA 94045, Hoa Kỳ.

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

    1. Đặt phần tử Atom <entry> vào 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 của nguồn cấp dữ liệu.

    Ví dụ: để thêm một người liên hệ vào danh sách example.com, hãy gửi yêu cầu POST đến URL sau:

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

    Máy chủ tạo người liên hệ và trả về mã trạng thái HTTP 201 CREATED, cùng với mục nhập người liên hệ mới. Mục được trả về bao gồm các phần tử do máy chủ tạo, chẳng hạn như <id>.

    Nếu yêu cầu không thành công, máy chủ sẽ trả về một mã trạng thái khác. Xem tài liệu tham khảo về giao thức Google Data API.

Các bước tiếp theo