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

Domain Shared Contacts API sử dụng các phần tử Google Data API tiêu chuẩn và các phần tử dành riêng cho danh bạ được chia sẻ.

Một mục nhập người liên hệ có dạng một loại Người liên hệ mở rộng Contact kind, đạ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> mà chứa nhiều phần tử mở rộng từ vùng chứa tên Google Data.

Phần tử category cho biết rằng 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 người liên hệ. Đối với các phần tử sau đây, 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ợ ảnh

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 ả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 bài viết 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ẽ thêm khả năng đọc ảnh được liên kết với người 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 người liên hệ. Đường liên kết sẽ không xuất hiện nếu không có ảnh cho người 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 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 vùng chứa tên này, một phần tử được xác định đại diện cho một nhóm mà người liên hệ thuộc về.

Thuộc tính gContact:groupMembershipInfo

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