Domain Shared Contacts API cho phép các ứng dụng nhận và cập nhật danh bạ bên ngoài được chia sẻ với tất cả người dùng trong một miền Google Workspace. Mọi người dùng trong miền Google Workspace đều có thể xem danh bạ dùng chung và tất cả các dịch vụ của Google đều có quyền truy cập vào danh sách liên hệ.
Sử dụng Domain Shared Contacts API để tạo, chỉnh sửa hoặc xoá danh bạ được chia sẻ và truy vấn những người liên hệ đáp ứng các tiêu chí cụ thể.
Domain Shared Contacts API chỉ dành cho tài khoản Google Workspace. Để sử dụng API này, hãy bật Domain Shared Contacts API trong Bảng điều khiển dành cho quản trị viên. Các thay đổi có thể mất đến 24 giờ mới xuất hiện trong tính năng tự động hoàn thành và trình quản lý danh bạ.
Tài liệu này cung cấp thông tin cơ bản về Domain Shared Contacts API và các ví dụ về cách quản lý danh bạ bằng XML và HTTP. Để tìm hiểu thêm, hãy xem thư viện ứng dụng.
Đối tượng
Tài liệu này dành cho những nhà phát triển đang viết các ứng dụng có chức năng thao tác với danh bạ trên Google bằng cách sử dụng HTTP và XML. Bạn cần có kiến thức về giao thức Google Data APIs.
Người dùng Linux và macOS có thể dùng thử các ví dụ trong tài liệu này bằng cách sử dụng curl hoặc wget. Xem bài viết Sử dụng curl với API dữ liệu của Google.
Nguyên tắc
Domain Shared Contacts API tuân theo các nguyên tắc của Google Data APIs. Google Data API dựa trên Atom 1.0, RSS 2.0 và Atom Publishing Protocol.
Chỉ định một phiên bản
Tất cả các yêu cầu được gửi bằng Domain Shared Contacts API đều phải chỉ định phiên bản 3.0:
GData-Version: 3.0
Nếu bạn không thể đặt tiêu đề HTTP, hãy chỉ định v=3.0 làm tham số truy vấn.
Bạn nên sử dụng phương thức tiêu đề HTTP.