Tài liệu tham khảo
Lỗi và giới hạn tỷ lệ
Lỗi REST sử dụng phong bì này. Giữ ID yêu cầu để được hỗ trợ và không bao giờ ghi lại khóa API của bạn:
Bắt đầu với mã và requestId
Mã ổn định cho chương trình của bạn biết điều gì đã xảy ra. Thông báo mà con người có thể đọc được giải thích yêu cầu này. Lưu requestId khi liên hệ với bộ phận hỗ trợ.
{
"error": {
"code": "UNAUTHORIZED",
"message": "The API key is missing, invalid, or revoked.",
"requestId": "req_..."
}
}Sửa lỗi xác thực và kế hoạch
Đối với 401, hãy kiểm tra xem tiêu đề có bắt đầu bằng Bearer theo sau là một dấu cách và khóa hoạt động hay không. Đối với 403, hãy kiểm tra gói tài khoản và phạm vi được chọn khi khóa được tạo.
Sửa lỗi trạng thái tải lên
Đối với 409 hoặc 422, hãy xác nhận PUT đã hoàn tất, Loại nội dung khớp và số byte được tải lên bằng sizeBytes. Tạo công việc tải lên mới nếu URL tạm thời hết hạn.
| Mã | HTTP | Ý nghĩa |
|---|---|---|
| BAD_REQUEST | 400 / 409 | HTTP 400 có nghĩa là nội dung yêu cầu không hợp lệ; HTTP 409 nghĩa là không thể hoàn tất quá trình tải lên ở trạng thái hiện tại. |
| UNAUTHORIZED | 401 | Khóa API bị thiếu, không hợp lệ hoặc bị thu hồi. |
| PAID_PLAN_REQUIRED | 403 | Tài khoản không có gói trả phí đủ điều kiện. |
| INSUFFICIENT_SCOPE | 403 | Khóa API không bao gồm phạm vi được yêu cầu. |
| NOT_FOUND | 404 | Không tìm thấy nội dung tải lên, tệp hoặc chia sẻ được sở hữu. |
| UPLOAD_NOT_READY | 409 | Đối tượng được tải lên chưa sẵn sàng để hoàn thành. |
| FILE_TOO_LARGE | 413 | Tệp vượt quá giới hạn kích thước áp dụng. |
| OBJECT_VALIDATION_FAILED | 422 | Đối tượng được tải lên không được xác thực. |
| QUOTA_EXCEEDED | 429 | Hạn ngạch tải lên đã hết. |
| RATE_LIMIT_EXCEEDED | 429 | Tỷ lệ yêu cầu API đã hết. |
| SERVICE_UNAVAILABLE | 503 | Một dịch vụ cần thiết tạm thời không có sẵn. |
Tiêu đề giới hạn tỷ lệ
Chỉ thử lại 429 sau Retry-After. Thử lại lỗi 503 tạm thời với thời gian chờ theo cấp số nhân. Không tự động thử lại các yêu cầu 400, 401 hoặc 403 không hợp lệ.