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

Hạn mức và giới hạn 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 Admin Settings API theo cách không phù hợp. Quá nhiều yêu cầu từ một API có thể là do lỗi chính tả không gây hại hoặc có thể là do hệ thống được thiết kế không hiệu quả, dẫn đế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à cần thiết cho tình trạng tổng thể của hệ thống Google Workspace. Việc 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 không mong muốn 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 bạn đã vượt quá hạn mức API nào. 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 các 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 các yêu cầu song song 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 theo tháng hoặc một khoảng thời gian khác. Trong trường hợp có các 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 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ả các lỗi dựa trên thời gian (tối đa N mục 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 để mã của mình bắt ngoại lệ và sử dụng thuật toán thời gian chờ luỹ tiế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 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 nên 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ễ ban đầu từ 5 giây lên 10 giây và thử lại lệnh gọi không thành công. Ngoài ra, hãy quyết định số lần thử lại tối đa. Ví dụ: thử lại một yêu cầu từ 5 đến 7 lần với các khoảng 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ã 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".
Tạo khoá công khai và khoá riêng tư

Với nhà cung cấp dịch vụ danh tính của bạn, hãy tạo một bộ khoá công khai và riêng tư bằng cách sử dụ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, vui lòng không sử dụng biểu trư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 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 Giới hạn 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 gần đây chưa kiểm tra cấu hình bản ghi MX của bạn hoặc bạn chưa định cấu hình bản ghi MX để 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à false, thì có thể là do bản ghi MX bạn cập nhật chưa được truyền tải hoặc bản ghi có lỗi chính tả. Để quá trình truyền tin diễn ra, bạn nên đợi khoảng thời gian được xác định bằng 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 bạn chưa tuỳ chỉnh tên tổ chức, 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 thị ngày và giờ bằng số

Xem ISO 8601, Biểu thị bằng số của Ngày và giờ.
Thẻ mã hoá ngôn ngữ

Xem thẻ ngôn ngữ RFC 3066 mà Google Mail chấp nhận.
Tên tổ chức

Nếu bạn chưa tuỳ chỉnh tên tổ chức, 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ể muốn 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à đang 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. Các yêu cầu điều chỉnh hạn mức 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 ngày càng sử dụng Google Cloud, các giá trị hạn mức có thể cần 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 trong Google Cloud Console.

Để tìm hiểu thêm, hãy xem các tài nguyên sau: