Hạn mức và hạn ngạch 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 quản trị 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 đánh máy vô hại hoặc do 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 lưu lượng truy cập đó đạt đến một mức nhất định là điều cần thiết để đảm bảo tình trạng tổng thể của hệ thống Google Workspace. Điều này đảm bảo rằng hành động của một nhà phát triển không thể ảnh hưởng tiêu cực đến cộng đồng lớn hơn.
Trong trường hợp hiếm hoi là yêu cầu API của bạn 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ề dữ liệu đầ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 hạn mức API nào đã bị vượt quá. Những 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à thực hiện hành động thích hợp.
Nếu bạn cần hoàn tất các yêu cầu trong một khoảng thời gian cố định, hãy gửi yêu cầu song song 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 một khoảng thời gian khác. Trong trường hợp có nhiều luồng, hãy thử bắt đầu với 10 luồng, mỗi luồng một yêu cầu. Lưu ý: đề xuất về luồng có những điểm đánh đổi và không hữu ích cho mọi 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ả lỗi dựa trên thời gian (tối đa N điều trong X giây cho mỗi luồng), đặc biệt là lỗi mã trạng thái 503, bạn nên dùng mã của mình để phát hiện ngoại lệ và sử dụng thuật toán thuật toán thời gian đợi tăng dần, đợi một khoảng thời gian ngắn trước khi thử lại lệnh gọi không thành công. Ví dụ về Email Settings API 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 chuỗi tin nhắn khác. Nếu yêu cầu thứ hai không thành công, ứng dụng của bạn nên giảm tần suất yêu cầu cho đến khi cuộc gọi thành công. Ví dụ: tăng độ trễ ban đầu từ 5 giây 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 số lần thử lại. Ví dụ: thử lại 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 của bạn trả về lỗi cho người dùng.
| Danh mục hạn mức API | Hạn mức |
|---|---|
| Mã 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à khoá riêng tư |
Với nhà cung cấp danh tính, hãy tạo một bộ khoá công khai và khoá riêng tư bằng thuật toán DSA hoặc RSA. Khoá công khai nằm trong chứng chỉ có định dạng X.509. Để biết thêm thông tin về 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 trư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 20 Kb. Khi sử dụng biểu trư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 trưng 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 xem Chính sách về biểu trưng và trang đích. |
| ssoWhitelist |
ssoWhitelist 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 hạn mức khác | Các hạn chế và nguyên tắc |
|---|---|
| Trạng thái xác minh bản ghi MX |
Trạng thái xác minh bản ghi MX mặc định là "false", tức là hệ thống của Google chưa kiểm tra cấu hình bản ghi MX của bạn gần đây hoặc bản ghi MX của bạn chưa được định cấu hình để trỏ đến hệ thống của Google. Nếu bạn đã cập nhật bản ghi và trạng thái xác minh vẫn là sai, thì có thể là do nội dung cập nhật bản ghi MX của bạn chưa được áp dụng hoặc có lỗi chính tả trong bản ghi. Để truyền dữ liệu, bạn nên đợi khoảng thời gian được xác định theo giá trị Thời gian tồn tại (TTL) của bản ghi MX rồi thử lại. |
| Mã quốc gia |
Nếu tên tổ chức chưa được tuỳ chỉnh, thì tên 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ự trong tên tổ chức, hãy xem phần Cách sử dụng ký tự. |
Thuộc tính creationTime, biểu diễn số của ngày và giờ |
Hãy xem ISO 8601, Biểu diễn số của ngày và giờ. |
| Thẻ mã hoá ngôn ngữ |
Xem 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ì tên 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ự trong tên tổ chức, hãy xem phần Cách sử dụng ký tự. |
Yêu cầu tăng hạn mức cho mỗi dự án
Tuỳ thuộc vào mức sử dụng tài nguyên của dự án, bạn có thể yêu cầu điều chỉnh hạn mức. Các lệnh gọi API của một tài khoản dịch vụ được coi là sử dụng một tài khoản duy nhất. Việc đăng ký hạn mức điều chỉnh không đảm bảo rằng bạn sẽ được phê duyệt. Những yêu cầu điều chỉnh hạn mức có thể làm tăng đáng kể giá trị hạn mức có thể mất nhiều thời gian hơn để được phê duyệt.
Không phải dự án nào cũng có hạn mức giống nhau. Khi bạn sử dụng Google Cloud ngày càng nhiều theo thời gian, giá trị hạn mức của bạn có thể cần phải tăng lên. Nếu dự kiến mức sử dụng sẽ tăng đáng kể trong thời gian tới, bạn có thể chủ động yêu cầu điều chỉnh hạn mức trên trang Hạn mức và giới hạn hệ thống trong Google Cloud Console.
Để tìm hiểu thêm, hãy xem các tài nguyên sau: