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 Alert Center API theo cách không phù hợp. Việc gửi 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 do một 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 để đảm bảo hệ thống Google Workspace hoạt động ổn định. Quy định 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 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ụ về các yêu cầu song song là yêu cầu các lô nhỏ email từ nhiều người dùng thay vì thêm hoặc xoá nhiều email của một người dùng cùng một lú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 email người dùng. Xin lưu ý rằng đề xuất về luồng có những điểm hạn chế và không hữu ích cho mọi trường hợp sử dụ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 thứ trong N 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. Một ví dụ về Alert Center 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 rồi thử lại cuộc 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ụ: hãy 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 giới hạn API Giới hạn
Tỷ lệ QPS và QPD của Trung tâm thông báo API này giới hạn số lượng yêu cầu cho dự án Bảng điều khiển API của bạn. Số lượng yêu cầu tối đa mỗi giây của dự án API (QPS dự án) là 1.000. Ngoài ra, số lượng yêu cầu tối đa mỗi người dùng mỗi giây (QPS của người dùng) là 150.

Nếu vượt quá các giới hạn này, máy chủ sẽ trả về mã trạng thái HTTP 503. Sử dụng thuật toán thời gian đợi luỹ thừa khi thử lại các yêu cầu.

Các loại hạn mức khác 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.
Yêu cầu trái phép Google không cho phép các yêu cầu trái phép gửi đến API này. Yêu cầu được coi là trái phép nếu không có mã thông báo uỷ quyền. Để biết thêm thông tin, hãy xem phần Uỷ quyền yêu cầu.

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. Những 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ủ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 trong Google Cloud Console.

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