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

Sau khi thiết lập tính năng xác thực, bạn có thể sử dụng API Danh bạ dùng chung của miền để phát hành các mục danh bạ dùng chung mới cho 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 địa chỉ email và trình quản lý danh bạ.

  1. Tạo một tệp XML đại diện cho người liên hệ dùng chung mà bạn muốn phát hành dưới dạng phần tử <entry> Atom của Loại người liên hệ. Tệp này có thể trông giố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ế nội dung sau:

    • FIRST_NAME: Tên của người liên hệ được chia sẻ, ví dụ: Alex.
    • LAST_NAME: Họ của người liên hệ được chia sẻ, 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 của người liên hệ được chia sẻ, 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ẻ, chẳng hạn như Mountain View.
    • ADDRESS: Địa chỉ đường phố của thông tin liên hệ dùng chung, 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 người 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 đó đến URL của nguồn cấp dữ liệu danh bạ:

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

    Ví dụ: để thêm một địa chỉ liên hệ dùng chung miền vào danh sách thuộc về example.com, hãy gửi yêu cầu POST kèm theo mục mới vào URL sau:

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

    Máy chủ Google tạo một thông tin 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 thông tin liên hệ mới ở dạng phần tử <entry>. Mục nhập được trả về giống với mục nhập mà bạn đã gửi, nhưng mục nhập này 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ề mã trạng thái, hãy xem tài liệu tham khảo về giao thức API Dữ liệu của Google.

Các bước tiếp theo