Sanggunian
Mga error at limitasyon sa rate
Ginagamit ng mga REST error ang sobreng ito. Panatilihin ang request ID para sa suporta at huwag kailanman i-log ang iyong API key:
Magsimula sa code at requestId
Ang stable code ay nagsasabi sa iyong programa kung ano ang nangyari. Ipinapaliwanag ng nababasa ng tao na mensahe ang kahilingang ito. I-save ang requestId kapag nakikipag-ugnayan sa suporta.
{
"error": {
"code": "UNAUTHORIZED",
"message": "The API key is missing, invalid, or revoked.",
"requestId": "req_..."
}
}Ayusin ang mga error sa pagpapatotoo at plano
Para sa 401, tingnan kung ang header ay nagsisimula sa Bearer na sinusundan ng isang puwang at isang aktibong key. Para sa 403, tingnan ang account plan at ang mga saklaw na napili noong ginawa ang key.
Ayusin ang mga error sa estado ng pag-upload
Para sa 409 o 422, kumpirmahin ang PUT tapos na, mga tugma ng Uri ng Nilalaman, at ang bilang ng na-upload na byte ay katumbas ng sizeBytes. Gumawa ng bagong trabaho sa pag-upload kung ang pansamantalang URL ay nag-expire.
| Kodigo | HTTP | Ibig sabihin |
|---|---|---|
| BAD_REQUEST | 400 / 409 | HTTP 400 ay nangangahulugan na ang katawan ng kahilingan ay hindi wasto; HTTP 409 ay nangangahulugan na ang pag-upload ay hindi makukumpleto sa kasalukuyang estado nito. |
| UNAUTHORIZED | 401 | Ang API key ay nawawala, hindi wasto, o binawi. |
| PAID_PLAN_REQUIRED | 403 | Ang account ay walang karapat-dapat na bayad na plano. |
| INSUFFICIENT_SCOPE | 403 | Ang API key ay hindi kasama ang kinakailangang saklaw. |
| NOT_FOUND | 404 | Hindi nahanap ang pag-aaring pag-upload, file, o pagbabahagi. |
| UPLOAD_NOT_READY | 409 | Ang na-upload na bagay ay hindi handa para sa pagkumpleto. |
| FILE_TOO_LARGE | 413 | Lumampas ang file sa naaangkop na limitasyon sa laki. |
| OBJECT_VALIDATION_FAILED | 422 | Nabigo sa pagpapatunay ang na-upload na bagay. |
| QUOTA_EXCEEDED | 429 | Naubos na ang quota sa pag-upload. |
| RATE_LIMIT_EXCEEDED | 429 | Naubos na ang API rate ng kahilingan. |
| SERVICE_UNAVAILABLE | 503 | Pansamantalang hindi available ang isang kinakailangang serbisyo. |
Mga header na may limitasyon sa rate
Subukang muli ang 429 pagkatapos lamang ng Retry-After. Subukang muli ang pansamantalang 503 error na may exponential backoff. Huwag awtomatikong subukang muli ang mga di-wastong 400, 401, o 403 na kahilingan.