常見錯誤

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

實體限制錯誤

EntityChildrenLimitReachedError

摘要
實體允許的子項數量已達上限，因此無法再新增子項。
建議的處理方式
建立新的實體類型，該類型已達到允許的子項數量上限，然後將您嘗試建立的子項實體新增至新類型。舉例來說，如果收到「LINE_ITEM_LIMIT_FOR_ORDER_REACHED」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

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

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 版本資訊，並定期升級。
  • 請訂閱我們的網誌，接收淘汰通知。

404 錯誤

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

Unmarshalling 錯誤

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