API di chuyển nhóm: giới hạn và hạn mức

Các giới hạn và hạn mức bảo vệ cơ sở hạ tầng của Google khỏi một quy trình tự động sử dụng API di chuyển Groups theo cách không phù hợp. Việc dùng một API quá nhiều yêu cầu có thể xảy ra do có lỗi chính tả không gây hại hoặc do một hệ thống được thiết kế kém hiệu quả khiến cho 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 cấp nhất định là cần thiết đối với tình trạng tổng thể của hệ thống Google Workspace.

Yêu cầu API không thành công

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 sẽ nhận được phản hồi mã trạng thái HTTP. Mã trạng thái HTTP của 403 có thông tin lỗi về việc nhập dữ liệu không chính xác, còn mã trạng thái HTTP của 503 có thông tin lỗi cho biết hạn mức API nào đã vượt quá hạn mức. 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à có biện pháp xử lý thích hợp.

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 tất 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#. Ví dụ: chia nhỏ yêu cầu theo tháng hoặc khoảng thời gian khác. Đối với luồng, hãy thử bắt đầu bằng 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ột số 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ả lỗi dựa trên thời gian (tối đa N thứ trong X giây trên mỗi luồng), đặc biệt là lỗi mã trạng thái 503, bạn nên phát hiện ngoại lệ và bằng cách sử dụng thuật toán thời gian đợi luỹ thừa, hãy đợi độ trễ nhỏ trước khi thử lại lệnh gọi không thành công. Ví dụ về API Di chuyển nhóm 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 sẽ giảm tần suất yêu cầu cho đến khi lệnh gọi thành công. Ví dụ: tăng độ trễ 5 giây ban đầu 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 một 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.

Các giới hạn

Danh mục hạn mức API	Các giới hạn
Số truy vấn mỗi giây (QPS)	Giới hạn dự án dành cho nhà phát triển là 10 truy vấn mỗi giây (QPS) trên mỗi tài khoản.

Hạn mức

Danh mục hạn mức API	Hạn mức
Số yêu cầu API tối đa mỗi ngày	Số yêu cầu API tối đa mỗi ngày là 500.000.
Lưu trữ, hết hạn thư	Bản lưu trữ nhóm không hết hạn. Tin nhắn vẫn được lưu trữ cho đến khi nhóm bị xoá. Chính sách giữ lại email không ảnh hưởng đến thư trong mục lưu trữ của nhóm.
Kích thước thư	Kích thước tối đa của thư là 25MB. Giới hạn này bao gồm tiêu đề siêu dữ liệu, nội dung và mọi tệp đính kèm của thư.

Các loại giới hạn khác

Các giới hạn khác	Giới hạn và nguyên tắc
Định dạng loại nội dung	Email phải ở định dạng văn bản RFC 822 tiêu chuẩn. Khi tải các email đã di chuyển lên, loại nội dung của yêu cầu phải sử dụng tiêu đề Content-type: message/rfc822.
Định dạng dữ liệu trong phản hồi của API	Định dạng dữ liệu của phản hồi là JavaScript Object Notation (JSON).
Chính sách vị trí dữ liệu	API Di chuyển Groups không hỗ trợ các chính sách về vị trí dữ liệu yêu cầu lưu trữ dữ liệu ở các ranh giới địa lý hoặc chính trị cụ thể vì lý do hợp đồng. Đừng sử dụng API di chuyển Groups nếu tài khoản của bạn cần có vị trí dữ liệu.
Chèn thông báo song song	API di chuyển nhóm hỗ trợ các yêu cầu song song về việc chèn email vào các tệp lưu trữ nhóm khác nhau. Tuy nhiên, API di chuyển nhóm không hỗ trợ tính năng chèn thông báo song song vào cùng một kho lưu trữ nhóm. Ngoài ra, phiên bản này của API di chuyển nhóm không hỗ trợ yêu cầu hàng loạt.
Yêu cầu không được phép	API di chuyển nhóm không chấp nhận bất kỳ yêu cầu trái phép nào. Một yêu cầu sẽ bị coi là trái phép nếu bạn không cung cấp mã uỷ quyền. Để biết thêm thông tin, hãy xem bài viết Tìm hiểu về quy trình xác thực và uỷ quyền.