錯誤和警告

本頁面將說明您在使用 Display & Video 360 API 時可能會遇到的不同類型錯誤和警告。

API 錯誤

無法完成的 API 要求會傳回錯誤訊息。傳回錯誤的要求會計入使用者配額，並在審查要求增加配額時納入考量。您應處理錯誤回應，以免日後發生錯誤。

錯誤回應採用以下格式，並包含 HTTP 回應代碼、錯誤訊息和 Google RPC 代碼狀態：

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

以下列出常見的 API 錯誤，以及在傳回錯誤時建議採取的行動：

注意： 如果採取建議的行動後，錯誤仍未解決，請與支援團隊聯絡，回報相關問題。

程式碼	單次點擊收益	建議做法
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 的內容中。
• 請確認您未超過每位使用者二十個並行 SDF 下載工作的限制。

如果仍發生錯誤，請與支援團隊聯絡，回報你的問題。

非阻斷式警告

非封鎖警告會指派給委刊項，用來指出可能影響委刊項放送的問題。類似的警告會透過通知橫幅在 UI 中顯示。這些警告屬於被動警告，並列在委刊項的 warningMessages 欄位中。

雖然這些警告是被動產生的，但造成這些警告的問題可能會影響委刊項的放送，甚至完全阻止放送。

預防方式

只要適當設定廣告項目，就能避免許多造成非阻斷警告的問題，包括：

• 檔期：如果委刊項的檔期無效，或是父項廣告訂單的檔期已過期，委刊項就會產生警告，且不會放送。為避免發生後者問題，請確認委刊項的檔期不會晚於其父項插入訂單的檔期。
• 已指派的廣告素材：如果委刊項未指派有效的廣告素材，系統會產生警告，且不會放送。
• 指定目標：如果委刊項的指定目標指派不正確，委刊項可能會產生警告，放送作業也可能會受到影響或完全停止。

如果您要複製現有委刊項的設定，請確認現有委刊項不會產生任何意外警告。

監控

在委刊項放送期間，可能會發生導致非阻礙性警告的問題。為確保委刊項放送正確，請監控有效委刊項是否有新產生的警告。您可以使用 advertisers.lineItems.list 函式大量擷取明細項目。如果委刊項產生非預期的警告，請立即解決問題，以減少對放送服務的影響。

即使委刊項的設定或指定目標未變更，仍可能發生問題。例如暫停或終止父項廣告訂單，以及淘汰使用者名單或其他指定目標。