錯誤和警告

本頁面將說明各種錯誤和警告類型，可以遇到的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`	您嘗試擷取的資源不能。確認您使用的身分證件是正確且適合要擷取的資源類型
`409`	`ABORTED`	你嘗試修改的資源處於以下狀態：並以其他位置修改請稍候片刻，接著再次提出要求。
`429`	`RESOURCE_EXHAUSTED`	已超過頻率限製或每日要求配額。使用 Google API 控制台並修改在現有配額內運作的工作流程詳情請參閱我們的網頁配額最佳化一文。如果無法在達到每日配額上限要求提高配額。
`500`	`INTERNAL`	API 發生內部錯誤。稍等一下，然後重試要求。如果錯誤請與支援團隊聯絡。
`504`	`DEADLINE_EXCEEDED`	API 完成要求的時間過長，請稍候片刻，然後重試要求。如果錯誤持續發生與支援團隊聯絡。

SDF 錯誤

顯示與Video 360 API 採用非同步方法，產生及下載結構化資料檔案 (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 時收到可行錯誤訊息，並按照指示操作。如果錯誤訊息無法明確採取行動，建議您採取以下行動：

確認使用者俱備父項的適當權限 partner 或廣告客戶資源。
確認篩選器中提供的 ID 正確無誤。分別位於已指定根 ID。
確認未超過並行 SDF 下載作業上限以及每位使用者的任務數量

如果問題仍未解決，請與支援團隊聯絡以回報問題

非封鎖警告

系統會指派非封鎖警告給委刊項，指出可能影響委刊項放送的問題出現類似警告調整顯示方式。這些警告屬於被動式警告列在委刊項的「warningMessages」欄位中

雖然被動，但造成這類警告的問題可能會影響完全阻擋著同樣的問題。

預防方式

許多造成非阻礙警告的問題都能透過適當的委刊項設定，包括：

檔期：如果委刊項的檔期無效，或上層廣告訂單的檔期已過期，委刊項會產生因此系統不會放送為避免這種情況發生，請確認一行程式碼項目的檔期結尾不得晚於父項插入項目的檔期順序。
指派的廣告素材：如果沒有有效的廣告素材委刊項會發出警示，但不會放送。
指定目標：如果委刊項的指定目標不是委刊項可能會產生警告可能受到影響或完全阻止

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

監控

委刊項檔期。為了確保委刊項能夠正確放送，請監控有效委刊項以接收新產生的警告委刊項可擷取 advertisers.lineItems.list 函式建立大量修改資料。如果委刊項收到非預期的警告，您應該解決以立即降低對廣告放送的影響

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