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

Domain Shared Contacts API sử dụng các phần tử API Dữ liệu tiêu chuẩn của Google và các phần tử dành riêng cho danh bạ dùng chung.

Mục nhập liên hệ có dạng Loại liên hệ mở rộng, đạ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 một tổ chức. Loại người 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ử mở rộng từ không gian tên Google Data.

Phần tử category cho biết mục nhập là một người liên hệ, có dạ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ử có tính hạn chế hơn một chút so với loại danh bạ. Đối với các phần tử sau, bạn cung cấp thuộc tính rel hoặc thuộc tính label, nhưng không được cung cấp 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ệ được chia sẻ, nếu bạn cung cấp cả rel và label hoặc không cung cấp cả hai cho bất kỳ phần tử nào trong số đó, thì máy chủ sẽ từ chối mục nhập.

Hỗ trợ về Photos

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

  • Với lệnh GET, rel="http://schemas.google.com/contacts/2008/rel#photo" sẽ có thêm khả năng đọc ảnh được liên kết với người liên hệ. Bạn có thể 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 người liên hệ. Đường liên kết sẽ không xuất hiện nếu người liên hệ không có ảnh.

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 xoá ả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" />

vùng chứa tên gContact

URL vùng chứa tên XML 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 để biểu thị một nhóm mà danh bạ thuộc về.

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 từng thuộc về. Nhóm được tham chiếu theo mã nhận dạng.
deleted="true" Có nghĩa là tư cách thành viên trong nhóm của người liên hệ đã bị xoá. Thuộc tính này chỉ được đưa vào nếu showdeleted được chỉ định làm tham số truy vấn, nếu không, groupMembershipInfo cho các nhóm mà một người liên hệ không còn thuộc về sẽ không được trả về.