Referencia
Errores y límites de tarifa
Los errores REST utilizan este sobre. Mantenga la solicitud ID de soporte y nunca registre su clave API:
Comience con código y requestId
El código estable le dice a su programa lo que sucedió. El mensaje legible por humanos explica esta solicitud. Guarde requestId cuando se comunique con el soporte.
{
"error": {
"code": "UNAUTHORIZED",
"message": "The API key is missing, invalid, or revoked.",
"requestId": "req_..."
}
}Corregir errores de autenticación y plan
Para 401, verifique que el encabezado comience con Bearer seguido de un espacio y una clave activa. Para 403, verifique el plan de cuenta y los alcances seleccionados cuando se creó la clave.
Corregir errores de estado de carga
Para 409 o 422, confirme que PUT haya finalizado, que el tipo de contenido coincida y que el recuento de bytes cargados sea igual a sizeBytes. Cree un nuevo trabajo de carga si el URL temporal expiró.
| Código | HTTP | Significado |
|---|---|---|
| BAD_REQUEST | 400 / 409 | HTTP 400 significa que el cuerpo de la solicitud no es válido; HTTP 409 significa que la carga no se puede completar en su estado actual. |
| UNAUTHORIZED | 401 | La clave API falta, no es válida o está revocada. |
| PAID_PLAN_REQUIRED | 403 | La cuenta no tiene un plan pago elegible. |
| INSUFFICIENT_SCOPE | 403 | La clave API no incluye el alcance requerido. |
| NOT_FOUND | 404 | No se encontró la carga, el archivo o el recurso compartido de propiedad. |
| UPLOAD_NOT_READY | 409 | El objeto cargado no está listo para ser completado. |
| FILE_TOO_LARGE | 413 | El archivo excede el límite de tamaño aplicable. |
| OBJECT_VALIDATION_FAILED | 422 | El objeto cargado no superó la validación. |
| QUOTA_EXCEEDED | 429 | La cuota de carga está agotada. |
| RATE_LIMIT_EXCEEDED | 429 | La tasa de solicitudes API está agotada. |
| SERVICE_UNAVAILABLE | 503 | Un servicio requerido no está disponible temporalmente. |
Encabezados de límite de tarifa
Vuelva a intentar 429 solo después de Reintentar después. Vuelva a intentar errores 503 temporales con retroceso exponencial. No reintente automáticamente solicitudes 400, 401 o 403 no válidas.