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

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

Mục liên hệ có dạng Loại liên hệ mở rộng, đại diện cho một người, đị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 thông tin 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 Dữ liệu của Google.

Phần tử category cho biết mục nhập là một thông tin liên hệ sẽ 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ế cao 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ệ dùng chung, nếu bạn cung cấp cả rel và label hoặc không cung cấp cho bất kỳ phần tử nào trong số đó, thì máy chủ sẽ từ chối mục nhập.

Nhóm hỗ trợ Photos

Cùng với các giá trị của thuộc tính chuẩn như self hoặc edit, bạn có thể sử dụng 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 bài viết Tìm hiểu về việc 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 chức năng đọc ảnh 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 liên kết với người liên hệ. Đường liên kết này sẽ không xuất hiện nếu người liên hệ không có hình ả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 chức 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" />

Không gian tên gContact

URL không gian 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 đại diện cho một nhóm mà người liên hệ 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 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àm 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ề.