常見錯誤

本頁說明 Google Ad Manager API 最常傳回的錯誤。錯誤會以 Error.REASON 格式傳回：

實體限制錯誤

EntityChildrenLimitReachedError

摘要
實體已達實體允許的子項數量上限，因此該實體無法再新增子項。
建議處理秘訣
建立達到子項數量上限的新實體類型，並將您要建立的子實體新增至新的實體。舉例來說，如果您收到 LINE_ITEM_LIMIT_FOR_ORDER_REACHED，就必須建立新的訂單，並將您嘗試建立的委刊項加入這個新訂單中。

配額錯誤

QuotaError.EXCEEDED_QUOTA

摘要
每秒提出的要求數量過高，已超過允許的上限。
建議處理秘訣
  • 請使用 updateLineItems 等批次方法，在本機收集變更，然後提出單一要求來同時完成這些變更。
  • 請等待約 5 秒鐘，然後再重試要求。請注意，這不保證要求一定會成功。如果再次失敗，請嘗試增加等待時間。這項建議適用於即時與 Ad Manager 整合的互動式應用程式。
  • 針對 Ad Manager 聯播網，請將要求限制為每秒 2 次，Ad Manager 360 聯播網則為每秒 8 次。再次提醒您，這並不保證每個要求都能成功，但可能有助於減少收到此錯誤的次數。我們建議針對整合不到即時互動功能的 Ad Manager 應用程式使用，例如執行夜間報表。

驗證錯誤

AuthenticationError.GOOGLE_ACCOUNT_ALREADY_ASSOCIATED_WITH_NETWORK

摘要
使用者嘗試使用已與網路建立關聯的帳戶建立測試網路。
常見原因
使用者在呼叫 NetworkService.makeTestNetwork() 前未建立新的 Google 帳戶。
建議處理秘訣
請先建立一個全新的帳戶，再呼叫 NetworkService.makeTestNetwork()。詳情請參閱如何建立測試網路。

AuthenticationError.NETWORK_CODE_REQUIRED

摘要
使用者未提供 networkCode。如要傳送要求，必須提供網路代碼。
常見原因
除了 NetworkService.getAllNetworks() 和 NetworkService.makeTestNetwork() 之外，所有要求都必須提供網路代碼。
建議處理秘訣
在要求標頭中加入要處理的網路代碼。只能使用您登入帳戶時可用的聯播網代碼。您可以在 Ad Manager 網站的 Ad Manager 網站中找到帳戶的程式碼，只要前往「管理」>「聯播網設定」頁面，即可在「聯播網代碼」旁找到。如要進一步瞭解如何設定聯播網代碼，請參閱 SOAP XML 要求和回應標頭頁面。

AuthenticationError.NETWORK_NOT_FOUND

摘要
在伺服器上找不到設定中提供的網路代碼，因此無法提出要求。
常見原因
您在設定中指定的網路代碼有誤。
建議處理秘訣
錯誤記錄的「觸發」欄位通常會建議使用者正確的網路。

AuthenticationError.NO_NETWORKS_TO_ACCESS

摘要
使用者未與任何網路建立關聯。
常見原因
您尚未為正式版帳戶啟用 API 存取權。
建議處理秘訣
啟用實際工作環境的 API 存取權。詳情請參閱啟用 API 存取權。

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

摘要
客戶尚未列入 API 存取權的許可清單中。
常見原因
您的聯播網未列入正式版的許可清單，但您在 SOAP 標頭中提供網路代碼。
建議處理秘訣
啟用 API 存取權。

權限錯誤

PermissionError.PERMISSION_DENIED

摘要
使用者沒有要求的必要權限。
常見原因
  • 您嘗試存取的物件位於其他網路中。
  • 您嘗試存取的是網路中的物件，但權限不足，無法讀取或更新。
  • 您嘗試執行的工作需要在帳戶中啟用額外功能。
建議處理秘訣
  • 如要建立 UI，請告知使用者他們沒有執行這項操作的權限，因此可以洽詢管理員。
  • 如果您嘗試執行工作 (例如涉及這項僅限付費功能)，但您的網路沒有權限執行的工作，請與客戶經理聯絡，瞭解如何啟用這項功能。
  • 請注意，測試聯播網預設為而非 Ad Manager 360 聯播網，也就是說，這些聯播網沒有 Ad Manager 360 聯播網中的付費功能。如要在測試網路中啟用功能，請與客戶經理聯絡。

版本錯誤

ApiVersionError.UPDATE_TO_NEWER_VERSION

摘要
應用程式：啟動需要較新版本才能成功的要求；或是向已淘汰版本發出的要求。
常見原因
  • API 呼叫的版本已淘汰。歡迎訂閱我們的網誌，查看淘汰公告。
  • 您提出的要求需要新版 API 才能成功。這類情況通常是使用者介面已引入某項功能，而為了讓 API 正確傳送物件，就需要新版 API。
建議處理秘訣
  • 隨時掌握 API 版本；規劃定期升級。
  • 訂閱我們的網誌，即可收到淘汰通知。

404 錯誤

摘要
伺服器未送達您的要求。
常見原因
你的網際網路連線或 Proxy 設定可能有誤，系統可能也會停用您要呼叫的 API 版本。
建議處理秘訣
檢查網際網路或 Proxy 設定，並確定您使用的是最新版本的 API。您可能也想將用戶端程式庫升級至最新版本。
預防秘訣
歡迎訂閱 Ad Manager API 論壇並瀏覽我們的網誌，隨時掌握 Ad Manager API 最新消息。

取消包裝錯誤

摘要
要求中的 SOAP XML 不符合 WSDL 規格。
常見原因
要求含有 WSDL 規格中未包含的欄位或實體，或位於錯誤的命名空間中。
要求中有類型不符 (例如，整數欄位含有字串值)。
建議處理秘訣
請確認要求符合 WSDL 規格。
使用用戶端程式庫產生有效的 SOAP，並用來進行比較。所有用戶端程式庫都支援記錄 SOAP 要求和回應。