Các giới hạn và hạn mức giúp 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 một API nhận được quá nhiều yêu cầu có thể là do lỗi chính tả không gây hại hoặc hệ thống được thiết kế không hiệu quả thực hiện 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 mức nhất định cần thiết cho tình trạng tổng thể của hệ thống Google Workspace.
Không gửi được yêu cầu API
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 của bạn sẽ nhận được mã trạng thái HTTP
của bạn. Mã trạng thái HTTP của 403 có thông tin lỗi cho biết hạn mức API
đã bị 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à thực hiện biện pháp xử lý phù hợp
hành động.
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 thành 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# của bạn. Ví dụ: chia nhỏ yêu cầu của bạn theo tháng hoặc khoảng thời gian khác. Đối với luồng, hãy thử bắt đầu với 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ọi 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ả các lỗi dựa trên thời gian (tối đa N thao tác trong X giây trên mỗi chuỗi), đặc biệt là
503 lỗi mã trạng thái, chúng tôi khuyên bạn nên phát hiện ngoại lệ trong mã và bằng cách sử dụng
một
thuật toán thời gian đợi luỹ thừa
hãy đợi một khoảng thời gian trễ ngắn 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 chuỗi sẽ đợ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 thao tác này
cho các luồng khác. Nếu yêu cầu thứ hai không thành công, đơn đăng ký của bạn sẽ
giảm tần suất của yêu cầu cho đến khi cuộc gọi thành công. Ví dụ: tăng
độ trễ 5 giây ban đầu xuống còn 10 giây rồi thử lại cuộc gọi không thành công. Ngoài ra, hãy quyết định thử lại
tối đa. Ví dụ: thử gửi lại một yêu cầu 5 đến 7 lần với thời gian trễ khác nhau trước khi đăng ký
sẽ 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 bạn cần vượt quá hạn mức hạn mức này, bạn có thể gửi yêu cầu từ Trang Hạn mức trong bảng điều khiển Google Cloud |
| Mô tả nhóm, kích thước tối đa | Bạn có thể nhập nội dung mô tả nhóm tối đa 4.096 ký tự. |
| Tên nhóm, quy mô tối đa | Tên của nhóm có thể có tối đa 60 ký tự. |
defaultMessageDenyNotificationText |
Nội dung thông báo có thể dài tối đa 10.000 ký tự. Để tìm hiểu thêm về chính sách
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ề maxMessageBytes
hãy xem tài liệu tham khảo API.
|
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 này cũng hỗ trợ định dạng Atom. Cả JSON và Atom hỗ trợ đầy đủ khả năng đọc-ghi. Để biết thêm thông tin, hãy xem Định dạng dữ liệu JSON và Atom. |
| API Cài đặt nhóm, bật | Bạn phải bật API Thư mục trước khi thực hiện lệnh gọi đến API Cài đặt nhóm Để biết thêm thông tin thông tin, hãy xem bài viết Bật API Google Workspace. |