Domain Shared Contacts API cho phép các ứng dụng của bạn 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ệ.
Ứng dụng của bạn có thể sử dụng Domain Shared Contacts API để tạo người liên hệ được chia sẻ, chỉnh sửa hoặc xoá người liên hệ được chia sẻ hiện có và truy vấn người liên hệ được chia sẻ phù hợp với một 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 đối với danh bạ dùng chung có thể mất đến 24 giờ mới xuất hiện trong tính năng tự động hoàn thành địa chỉ email và trình quản lý danh bạ.
Ngoài việc cung cấp thông tin cơ bản về các chức năng của Domain Shared Contacts API, tài liệu này còn đưa ra ví dụ về cách quản lý danh bạ bằng cách sử dụng XML và HTTP. Sau khi đọc tài liệu này, bạn có thể tìm hiểu thêm về cách tương tác với API bằng cách sử dụng thư viện ứng dụng của chúng tôi.
Đối tượng
Tài liệu này dành cho những nhà phát triển muốn viết các ứng dụng có thể thao tác với danh sách liên hệ của Google bằng cách sử dụng HTTP và XML. Tài liệu này giả định rằng bạn hiểu những nguyên tắc cơ bản đằng sau giao thức API dữ liệu của Google.
Nếu đang dùng hệ điều hành UNIX và muốn dùng thử các ví dụ trong tài liệu này mà không cần viết mã, hãy dùng các tiện ích dòng lệnh UNIX curl hoặc wget. Tìm hiểu cách sử dụng cURL với các dịch vụ dữ liệu của Google.
Nguyên tắc
Phiên bản Domain Shared Contacts API này tuân theo các nguyên tắc của Google Data API. Google Data API dựa trên cả định dạng phân phối Atom 1.0 và RSS 2.0, ngoài Giao thức xuất bản Atom.
Chỉ định một phiên bản
Mọi yêu cầu mà bạn gửi bằng Domain Shared Contacts API đều phải chỉ định phiên bản 3.0 của API:
GData-Version: 3.0
Nếu không thể đặt tiêu đề HTTP, bạn có thể chỉ định v=3.0 làm tham số truy vấn trong URL, nhưng bạn nên sử dụng phương thức tiêu đề HTTP.