本頁面說明您在使用 Display & Video 360 API 時，可能會遇到的各種錯誤和警告。
API 錯誤
向 API 發出無法完成的要求會傳回錯誤訊息。傳回錯誤的要求會計入使用者配額，而且在審查額外配額的要求時，會一併考量這類要求。請處理並處理錯誤回應，避免日後發生錯誤。
錯誤回應會採用下列格式，其中包含 HTTP 回應代碼、錯誤訊息和 Google RPC 代碼狀態：
{
"error": {
"code": integer,
"message": string,
"status": enum (google.rpc.Code)
}
}
以下列出常見的 API 錯誤，以及傳回時建議採取的動作：
| 程式碼 | RPC | 建議做法 |
|---|---|---|
400
|
INVALID_ARGUMENT
|
你的要求發生問題。請查看錯誤回應中的訊息欄位，並據此修改要求。 |
401
|
UNAUTHENTICATED
|
無法正確驗證您的要求。請確認您在要求中加入有效的 OAuth 憑證。詳情請參閱入門指南。 |
403
|
PERMISSION_DENIED
|
您沒有完成要求所需的權限。確認您的使用者帳戶具備相關夥伴或廣告客戶的適當權限。 |
404
|
NOT_FOUND
|
找不到您要擷取的資源。確認您使用的 ID 是否正確，以及要擷取的資源類型。 |
409
|
ABORTED
|
您嘗試修改的資源正在其他位置經過修改。請稍候片刻，然後重試要求。 |
429
|
RESOURCE_EXHAUSTED
|
已超出頻率限製或每日要求配額。使用 Google API 控制台檢查 API 用量，並修改工作流程，以便在現有的配額限制內運作。詳情請參閱配額最佳化頁面。 如果無法在指定的每日配額內完成作業，您可以要求增加配額。 |
500
|
INTERNAL
|
API 發生內部錯誤。請稍候片刻，然後再重試要求。如果錯誤持續發生，請與支援團隊聯絡。 |
504
|
DEADLINE_EXCEEDED
|
API 完成要求的時間過長，請稍候片刻，然後再重試要求。如果錯誤持續發生，請與支援團隊聯絡。 |
SDF 錯誤
Display & Video 360 API 會使用非同步方法來產生及下載結構化資料檔案 (SDF)。因此，系統會在完成的 SDF 下載工作中傳回「期間」產生的 SDF 錯誤。在 error 中完成的 SDF 下載工作會標示為已完成，但 response 欄位中已填入錯誤欄位，而非媒體資源名稱，如以下截斷範例所示：
{
...
"done": true,
"error": {
"code": 3,
"message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
}
}
如果您在嘗試產生 SDF 時收到可採取行動的錯誤訊息，請依照下列步驟操作。如果錯誤訊息無法清楚採取行動，建議您採取下列行動：
- 確認您的使用者俱備上層合作夥伴或廣告客戶資源的適當權限。
- 確認篩選器中提供的 ID 正確無誤、對應至預定資源類型，而且位於指定的根 ID 內容中。
- 確認不超過每位使用者的 20 個並行 SDF 下載工作上限。
如果還是發生錯誤，請與支援團隊聯絡以回報問題。
非封鎖警告
系統會將非封鎖警告指派給委刊項，用於指出可能會影響委刊項放送的問題。系統會在 UI 中透過通知橫幅提供類似的警告。這些警告屬於被動式，並且會列在委刊項的 warningMessages 欄位。
雖然被動性，但造成這些警告的問題可能會影響到完全阻礙委刊項放送的位置。
預防方式
只要進行適當的委刊項設定，即可避免許多會導致非封鎖警告的問題，包括：
- 檔期：如果委刊項的檔期無效，或上層廣告訂單的檔期已過期，則委刊項將產生警告且不會放送。為了避免遇到第二種問題，請確定委刊項的檔期結束日期不會晚於上層廣告訂單的檔期。
- 已指派的廣告素材：如果替委刊項沒有指派有效的廣告素材，委刊項就會產生警告且不會放送。
- 指定目標：如果未正確指派委刊項的指定目標，委刊項可能會產生警告，並有可能影響或完全無法運作。
如果您是從現有委刊項複製設定，請確認該委刊項不會產生任何非預期的警告。
Monitoring
在委刊項放送期間，可能會導致發生非阻塞警告的問題。為確保委刊項正確放送，請監控有效委刊項是否出現新產生的警告。您可以使用 advertisers.lineItems.list 函式大量擷取委刊項。如果委刊項產生非預期的警告，建議您立即解決問題，減少廣告放送的影響。
即使委刊項設定或指定目標沒有改變，也可能會引發問題。 例如上層廣告訂單的暫停或過期，以及使用者名單或其他指定目標的淘汰。