錯誤和警告

Display & Video 360 API 可能會傳回多種錯誤和警告。健全的 API 解決方案必須處理這些錯誤。

API 錯誤

如果 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 Cloud 控制台檢查 API 用量。請更新工作流程，在現有配額限制內執行。詳情請參閱「用量最佳化」指南。
500	INTERNAL API 發生內部錯誤。請稍候片刻，然後重試要求。如果錯誤持續發生，請與支援團隊聯絡。
504	DEADLINE_EXCEEDED API 處理要求的時間過長。請稍候片刻，然後重試要求。如果錯誤持續發生，請與支援團隊聯絡。

SDF 錯誤

Display & Video 360 API 會使用長時間執行的工作產生結構化資料檔案 (SDF)。建立 SDF 時發生的錯誤會傳回至完成的 operation。error 欄位會包含詳細資料。請參閱以下截斷的範例：

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

如果錯誤訊息不清楚，建議採取下列做法：

• 確認使用者在父項合作夥伴或廣告主中，至少具備標準使用者角色。
• 確認篩選器中提供的 ID 正確無誤。 ID 必須對應至預期資源類型，且必須是根 ID 的子項資源。
• 請確認使用者同時執行的 SDF 下載工作少於 20 項。

如果還是出現錯誤，請聯絡支援團隊。

非阻礙性警告

不會封鎖的警告表示有問題可能會影響廣告放送。使用者介面也會顯示類似警告。這些警告是被動的，會列在委刊項中。

警告的根本原因可能會影響委刊項的放送。在某些情況下，這可能會導致廣告完全無法放送。

預防方式

部分非封鎖警告是由委刊項設定錯誤所致：

• 檔期：如果委刊項的檔期無效，或廣告訂單的檔期已過期，委刊項就不會放送廣告。請確認委刊項的檔期在廣告訂單的檔期內。
• 已指派的廣告素材：如果沒有將有效的廣告素材指派給委刊項，該委刊項就無法放送。
• 指定目標：如果未正確指派委刊項的指定目標，可能會影響廣告放送，甚至完全無法放送。

請確認現有委刊項未產生任何警告，再將其設定用於新委刊項。

監控

委刊項放送期間可能會出現非封鎖警告。監控有效委刊項的新警告，確保委刊項正常放送。使用 list 要求大量取得委刊項。如果委刊項傳回不符預期的警告，請盡快解決問題，減少對放送的影響。

即使設定或指定目標沒有變更，系統仍可能新增警告。例如：

• 廣告訂單已暫停或過期。
• 使用者名單或指定選項已淘汰。