Tổng quan về API cài đặt nhóm

API Cài đặt nhóm cập nhật và truy xuất chế độ cài đặt cho một Nhóm Google hiện có. Thông qua API, bạn có thể làm những việc sau:

  • Sửa đổi chế độ cài đặt của nhóm để cấp quyền truy cập cho nhóm nội bộ và bên ngoài.
  • Chỉnh sửa thông báo của nhóm.
  • Định cấu hình tính năng lưu trữ cuộc thảo luận và kiểm duyệt thư.
  • Tuỳ chỉnh nhóm người dùng của tài khoản.

Để biết thêm cách làm việc với Google Groups hoặc quản lý các loại nhóm khác, hãy xem tài liệu về Cloud Identity.

Mô hình dữ liệu API Cài đặt nhóm

API Cài đặt nhóm hoạt động trên tài nguyên Groups, thể hiện cách người dùng trong một tài khoản giao tiếp và cộng tác với các nhóm người khác. Mỗi nhóm được xác định theo địa chỉ email của nhóm.

Mô hình dữ liệu API dựa trên tập hợp Groups của các nhóm tài khoản. Mỗi nhóm có một nhóm chế độ cài đặt cấu hình riêng.

Hoạt động của API Cài đặt nhóm

Bạn có thể gọi các phương thức cài đặt nhóm trong API Cài đặt nhóm, như mô tả trong bảng sau:

Hoạt động Mô tả Liên kết HTTP REST
get Xem chế độ cài đặt nhóm cho tài khoản của khách hàng. Tất cả các thao tác get phải được một người dùng đã xác thực cho phép. GET trên URI nhóm.
update Cập nhật chế độ cài đặt của nhóm cho tài khoản của khách hàng. Tất cả thao tác cập nhật phải được người dùng đã xác thực cho phép. PUT trên URI nhóm.

Định dạng dữ liệu JSON và Atom

Theo mặc định, API Cài đặt nhóm trả về dữ liệu ở định dạng JSON. Ký hiệu Atom là một định dạng dữ liệu thay thế. Cả định dạng dữ liệu JSON và Atom đều hỗ trợ đầy đủ chức năng đọc-ghi.

JSON là một định dạng Internet phổ biến cung cấp phương thức biểu thị các cấu trúc dữ liệu tuỳ ý. Theo json.org, JSON là một định dạng văn bản hoàn toàn độc lập với ngôn ngữ nhưng sử dụng các quy ước quen thuộc với lập trình viên của các ngôn ngữ thuộc họ C, bao gồm C, C++, C#, Java, JavaScript, Perl và Python.

Để thay đổi định dạng dữ liệu của API, hãy đưa chuỗi truy vấn alt vào URI của yêu cầu, ví dụ:

JSON

GET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=json

Atom

GET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=atom