Hạn mức và hạn mức sử dụng

Hạn mức và hạn mức giúp bảo vệ cơ sở hạ tầng của Google khỏi quy trình tự động sử dụng API Cài đặt quản trị viên theo cách không phù hợp. Yêu cầu quá mức từ một API có thể là do lỗi chính tả vô hại hoặc có thể do một 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. Dù lý do 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 để đảm bảo sức khỏe tổng thể của hệ thống Google Workspace. Quy trình này giúp đảm bảo rằng các hành động của một nhà phát triển không thể tác động tiêu cực đến cộng đồng lớn.

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

Nếu các yêu cầu 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ụ: ngắt các yêu cầu của bạn theo tháng hoặc một khoảng thời gian khác. Trong trường hợp luồng, hãy thử bắt đầu với 10 luồng, mỗi luồng một yêu cầu. Xin lưu ý rằng đề xuất luồng có một sự đánh đổi và không hữu ích trong tất cả các tình huống API. Nếu số lượng yêu cầu quá cao, lỗi hạn mức sẽ xảy ra.

Đối với tất cả các lỗi dựa trên thời gian (tối đa N nội dung cho X giây mỗi chuỗi), đặc biệt là lỗi mã trạng thái 503, chúng tôi khuyên bạn nên phát hiện mã ngoại lệ và sử dụng thuật toán thời gian đợi luỹ thừa, hãy đợi một chút chậm trễ trước khi thử lại lệnh gọi không thành công. Ví dụ về API cài đặt email cho một chuỗi cuộc trò chuyện là đợi 5 giây rồi thử gọi lạ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 chuỗi thư khác. Nếu yêu cầu thứ hai không thành công, ứng dụng của bạn sẽ được điều chỉnh lại theo 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 lên 10 giây rồi thử gọi lại không thành công. Ngoài ra, bạn cũng có thể quyết định giới hạn thử lại. Ví dụ: thử lại yêu cầu từ 5 đến 7 lần với thời gian trễ khác nhau trước khi ứng dụng trả về lỗi cho người dùng.

Danh mục hạn mức API	Hạn mức
Mã thông báo xác thực ClientLogin	Có hiệu lực trong 24 giờ. Lỗi là "mã thông báo 401 đã hết hạn".
Đang tạo khoá công khai và riêng tư	Với nhà cung cấp danh tính của bạn, hãy tạo một tập hợp các khóa công khai và riêng tư bằng thuật toán DSA hoặc RSA. Khoá công khai này có chứng chỉ được định dạng X.509. Để biết thêm thông tin về các khoá ký Đăng nhập một lần dựa trên SAML, hãy xem bài viết Tạo khoá và chứng chỉ cho Dịch vụ đăng nhập một lần của Google Workspace.
Biểu trưng	Tệp hình ảnh biểu tượng của tài khoản có thể ở định dạng JPEG, PNG hoặc GIF. Kích thước đề xuất là 143 x 59 pixel và tệp phải nhỏ hơn 20Kb. Khi sử dụng biểu tượng tuỳ chỉnh, hãy nhớ tuân thủ Điều khoản dịch vụ của Google. Đồng thời, không sử dụng biểu tượng của Google, biểu trưng của Gmail hoặc bất kỳ biểu trưng nào khác của Google. Để biết thêm thông tin, hãy tham khảo phần Chính sách về biểu tượng và trang đích.
Danh sách cho phép sso	ssoDanh sách trắng là địa chỉ IP mặt nạ mạng ở định dạng Định tuyến liên miền không phân lớp (CIDR).

Các loại giới hạn khác	Giới hạn và nguyên tắc
Trạng thái xác minh của bản ghi MX	Trạng thái xác minh bản ghi MX mặc định là `false`, nghĩa là hệ thống của Google gần đây chưa kiểm tra cấu hình bản ghi MX của bạn hoặc bản ghi MX của bạn chưa được định cấu hình để trỏ đến các hệ thống của Google. Nếu bạn đã cập nhật các bản ghi nhưng trạng thái xác minh vẫn là sai, thì có thể nội dung cập nhật trong bản ghi MX của bạn chưa được lan truyền hoặc có lỗi chính tả trong bản ghi. Để truyền, chúng tôi khuyên bạn nên đợi khoảng thời gian được xác định bởi giá trị Thời gian tồn tại (TTL) của bản ghi MX và thử lại.
Mã quốc gia	Nếu tên tổ chức chưa được tuỳ chỉnh, thì chế độ mặc định sẽ là tên miền chính của bạn. Để biết thông tin về các ký tự của tên tổ chức, hãy xem phần Sử dụng ký tự.
Thuộc tính creationTime, biểu diễn ngày và giờ bằng số	Xem ISO 8601, Bản trình bày dạng số của Ngày và giờ.
Thẻ mã hoá ngôn ngữ	Xem các thẻ ngôn ngữ RFC 3066 được Google Mail chấp nhận.
Tên tổ chức	Nếu tên tổ chức chưa được tuỳ chỉnh, thì chế độ mặc định sẽ là tên miền chính của bạn. Để biết thông tin về các ký tự của tên tổ chức, hãy xem phần Sử dụng ký tự.