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 Google Groups hiện có. Thông qua API này, bạn có thể làm những việc sau:

  • Sửa đổi chế độ cài đặt của nhóm đối với quyền truy cập của 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 trong tài khoản của bạn.

Để biết thêm các cách làm việc với Nhóm Google 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 Groups Settings API

Groups Settings API hoạt động trên tài nguyên Groups. Tài nguyên này 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 bằng địa chỉ email của nhóm.

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

Các thao tác của Groups Settings API

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

Hoạt động Mô tả Mối liên kết HTTP REST
get Lấy chế độ cài đặt của một nhóm cho tài khoản của khách hàng. Tất cả các thao tác get đều 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 một nhóm cho tài khoản của khách hàng. Tất cả các thao tác cập nhật đều 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, Groups Settings API sẽ 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 đủ các chức năng đọc-ghi.

JSON là một định dạng phổ biến trên Internet, 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ề ngôn ngữ nhưng sử dụng các quy ước quen thuộc với các lập trình viên thuộc họ ngôn ngữ C, bao gồm C, C++, C#, Java, JavaScript, Perl và Python.

Bạn có thể thay đổi định dạng dữ liệu của API bằng cách thêm 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