常見錯誤

本頁面說明 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

摘要
使用者嘗試建立測試聯播網，但使用的帳戶已與聯播網建立關聯。
常見原因
使用者未先建立新的 Google 帳戶，就呼叫 NetworkService.makeTestNetwork()。
建議處理方式
請先建立全新帳戶，再呼叫 NetworkService.makeTestNetwork()。詳情請參閱如何建立測試聯播網。

AuthenticationError.NETWORK_CODE_REQUIRED

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

AuthenticationError.NETWORK_NOT_FOUND

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

AuthenticationError.NO_NETWORKS_TO_ACCESS

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

AuthenticationError.NOT_WHITELISTED_FOR_API_ACCESS

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

權限錯誤

PermissionError.PERMISSION_DENIED

摘要
使用者沒有要求的必要權限。
常見原因
  • 您嘗試存取的物件位於其他網路。
  • 您嘗試存取聯播網中的物件，但沒有讀取或更新權限。
  • 您嘗試執行的工作需要啟用帳戶的額外功能。
建議處理方式
  • 如果您正在建立使用者介面，請向使用者說明他們沒有執行這項操作的權限，並請他們與管理員聯絡。
  • 如果您嘗試執行的工作涉及聯播網無權使用的付費功能，請與客戶經理聯絡，要求對方啟用這項功能。
  • 請注意，測試聯播網預設不是 Ad Manager 360 聯播網，因此不具備 Ad Manager 360 聯播網的付費功能。如要在測試聯播網上啟用功能，請與客戶經理聯絡。

版本錯誤

ApiVersionError.UPDATE_TO_NEWER_VERSION

摘要
應用程式發出的要求需要較新版本 才能成功，或發出的要求指向已淘汰的版本。
常見原因
  • API 呼叫版本已淘汰。請訂閱我們的網誌，接收淘汰公告。
  • 您提出的要求必須使用較新版本的 API 才能成功。如果使用者介面中已推出某項功能，但 API 必須使用較新版本才能正確傳送物件，通常就會發生這種情況。
建議處理方式
  • 隨時掌握最新的 API 版本資訊，並定期升級。
  • 訂閱我們的網誌，接收淘汰通知。

404 錯誤

摘要
你的要求未傳送至伺服器。
常見原因
網際網路連線或 Proxy 可能設定錯誤。您呼叫的 API 版本也可能已淘汰。
建議處理方式
請檢查網際網路或 Proxy 設定，並確認您使用的是最新版 API。建議您一併將用戶端程式庫升級至最新版本。
預防秘訣
請查看 Ad Manager 產品討論社群和我們的網誌，隨時掌握 Ad Manager API 的最新消息。

取消封送處理錯誤

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