Giới hạn sử dụng API

Các giới hạn và hạn mức bảo vệ cơ sở hạ tầng của Google khỏi một quy trình tự động sử dụng API Cài đặt nhóm theo cách không phù hợp. Việc dùng một API quá nhiều yêu cầu có thể dẫn đến lỗi chính tả vô hại hoặc do một hệ thống được thiết kế kém hiệu quả khiến cho các lệnh gọi API không cần thiết. Bất kể nguyên nhân là gì, việc chặn lưu lượng truy cập từ một nguồn cụ thể khi nguồn đó đạt đến một cấp nhất định là cần thiết đối với tình trạng chung của hệ thống Google Workspace.

Yêu cầu API không thành công

Trong trường hợp hiếm gặp là yêu cầu API của bạn không thành công, ứng dụng sẽ nhận được phản hồi mã trạng thái HTTP. Mã trạng thái HTTP của 403 có thông tin lỗi cho biết hạn mức API nào đã vượt quá. Phản hồi này cho phép ứng dụng tuỳ chỉnh của bạn phát hiện lỗi và có biện pháp xử lý thích hợp.

Yêu cầu có giới hạn thời gian

Nếu yêu cầu của bạn cần được hoàn tất trong một khoảng thời gian cố định, hãy gửi song song các yêu cầu hoặc sử dụng nhiều luồng trong ứng dụng Java hoặc C#. Ví dụ: chia nhỏ yêu cầu theo tháng hoặc khoảng thời gian khác. Đối với luồng, hãy thử bắt đầu bằng 10 luồng, mỗi luồng một yêu cầu. Đề xuất về luồng có một số đánh đổi và không hữu ích cho một số trường hợp API. Nếu số lượng yêu cầu quá cao, sẽ xảy ra lỗi hạn mức.

Lỗi dựa trên thời gian

Đối với tất cả lỗi dựa trên thời gian (tối đa N thứ trong X giây trên mỗi luồng), đặc biệt là lỗi mã trạng thái 503, bạn nên phát hiện ngoại lệ và bằng cách sử dụng thuật toán thời gian đợi luỹ thừa, hãy đợi một độ trễ nhỏ trước khi thử lại lệnh gọi không thành công. Ví dụ về API Cài đặt nhóm cho một luồng là đợi 5 giây rồi thử lại lệnh gọi không thành công. Nếu yêu cầu thành công, hãy lặp lại mẫu này cho các luồng khác. Nếu yêu cầu thứ hai không thành công, ứng dụng của bạn sẽ giảm tần suất yêu cầu cho đến khi một lệnh gọi thành công. Ví dụ: tăng độ trễ 5 giây ban đầu lên 10 giây rồi thử lại lệnh gọi không thành công. Ngoài ra, hãy quyết định giới hạn thử lại. Ví dụ: thử lại một yêu cầu từ 5 đến 7 lần với các thời gian trễ khác nhau trước khi ứng dụng trả về lỗi cho người dùng.

Hạn mức

Danh mục hạn mức API Hạn mức
Số truy vấn mỗi ngày

Bạn có thể thực hiện tối đa 100.000 truy vấn mỗi ngày. Nếu cần dung lượng vượt quá giới hạn này, bạn có thể gửi yêu cầu trên trang Hạn mức trong bảng điều khiển Google Cloud
Nội dung mô tả nhóm, kích thước tối đa Bạn có thể nhập nội dung mô tả nhóm với tối đa 300 ký tự.
Tên nhóm, kích thước tối đa Tên nhóm có thể có tối đa 60 ký tự.
defaultMessageDenyNotificationText Văn bản thông báo có thể dài tối đa 10.000 ký tự. Để tìm hiểu thêm về thuộc tính defaultMessageDenyNotificationText, hãy xem Tài liệu tham khảo API.
maxMessageBytes Kích thước thư tối đa mặc định là 1MB. Để tìm hiểu thêm về thuộc tính maxMessageBytes, vui lòng xem Tài liệu tham khảo API.

Các giới hạn

Các loại giới hạn Giới hạn và nguyên tắc
Định dạng dữ liệu, mặc định
 Định dạng dữ liệu mặc định là JSON. API cũng hỗ trợ định dạng Atom. Cả hai định dạng dữ liệu JSON và Atom đều hỗ trợ khả năng đọc-ghi đầy đủ. Để biết thêm thông tin, hãy xem bài viết Các định dạng dữ liệu JSON và Atom.
API Cài đặt nhóm, bật Bạn phải bật Directory API trước khi thực hiện lệnh gọi đến Groups Settings API (API Cài đặt nhóm). Để biết thêm thông tin, hãy xem phần Bật API Google Workspace.