Các thành phần liên hệ được chia sẻ

API Danh bạ được chia sẻ của miền sử dụng các thành phần tiêu chuẩn của Google Data API và các phần tử dành riêng cho danh sách liên hệ được chia sẻ.

Mục nhập địa chỉ liên hệ có dạng thông tin mở rộng Loại liên hệ, đại diện cho một người, một địa điểm (chẳng hạn như câu lạc bộ hoặc nhà hàng) hoặc tổ chức. Loại địa chỉ liên hệ xuất hiện trong XML dưới dạng phần tử <atom:entry> chứa nhiều phần tử tiện ích trong không gian tên Dữ liệu trên Google.

Phần tử category cho biết mục nhập là một địa chỉ liên hệ sẽ giống như sau:

<atom:category scheme="http://schemas.google.com/g/2005#kind"
  term="http://schemas.google.com/contact/2008#contact"/>

Trong Domain Shared Contacts API, một số phần tử hạn chế hơn một chút so với loại thông tin liên hệ. Đối với các phần tử sau, bạn cần cung cấp rel hoặc một thuộc tính label, nhưng không phải cả hai:

  • gd:email
  • gd:im
  • gd:organization
  • gd:phoneNumber
  • gd:structuredPostalAddress

Khi bạn tạo hoặc cập nhật một người liên hệ dùng chung, nếu bạn cung cấp cả rel và label hoặc không đối với bất kỳ phần tử nào trong số đó, thì máy chủ sẽ từ chối mục nhập.

Hỗ trợ Photos

Cùng với tài sản chuẩn các giá trị như bản thân hoặc chỉnh sửa, bạn có thể sử dụng rel giá trị cho các phần tử atom:link. Khi sử dụng đường liên kết đến ảnh, mã thông báo uỷ quyền trong thì phải chỉ định tiêu đề HTTP. Để biết thêm thông tin, hãy xem Tìm hiểu về tính năng xác thực và uỷ quyền.

  • Với lệnh GET, rel="http://schemas.google.com/contacts/2008/rel#photo" sẽ thêm đọc hình ảnh liên quan đến địa chỉ liên hệ đó. Bạn có thể sử dụng URL được chỉ định trong href để đọc phiên bản mới nhất của ảnh được liên kết với địa chỉ liên hệ đó. Đường liên kết sẽ không xuất hiện nếu không có ảnh cho địa chỉ liên hệ đó.

Ví dụ:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234" type="image/*" />
  • Với lệnh PUT hoặc DELETE, rel="http://schemas.google.com/contacts/2008/rel#edit-photo" sẽ thêm khả năng cập nhật hoặc xóa ảnh cục bộ được liên kết với người liên hệ đó.

Ví dụ:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#edit-photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234/photo4524" />

Không gian tên gContact

URL không gian tên XML dành cho gContact là http://schemas.google.com/contact/2008.

Trong không gian tên này, một phần tử được xác định đại diện cho một nhóm mà địa chỉ liên hệ đó.

gContact:groupMembershipInfo cơ sở lưu trú

Thuộc tính Mô tả
href Xác định nhóm mà người liên hệ thuộc về hoặc thuộc về. Chiến lược phát hành đĩa đơn được tham chiếu theo mã nhận dạng của nhóm.
deleted="true" Có nghĩa là người liên hệ đã bị xoá tư cách thành viên nhóm. Chiến dịch này chỉ được đưa vào nếu showdeleted được chỉ định dưới dạng tham số truy vấn, nếu không thì groupMembershipInfo cho các nhóm mà một người liên hệ không còn là thành viên của họ sẽ không được trả về.