疑難排解

在許多情況下，您在使用 Display & Video 360 API 時，都可能會遇到錯誤。這些錯誤可能與程式碼中的錯誤、使用者輸入的無效資料，甚至是 API 本身的問題有關。無論原因為何，瞭解如何排解錯誤都是開發過程中重要的一環。本指南將提供一些最佳做法提示，協助您快速上手。

回顧基本概念

請參閱必要條件指南。請確認您有權存取 Display & Video 360，且已正確設定 API 專案。
如果回應包含 HTTP 錯誤，請務必仔細檢查這些錯誤，並確保要求是針對正確的 API 和服務提出。
請參閱授權指南。請確認要求包含必要的 OAuth 2.0 憑證。
請確認您使用的是正確的憑證。如要進一步瞭解如何產生驗證憑證，請參閱「設定應用程式指南」。您也可以將存取權杖傳遞至 Google OAuth2 API 的 tokeninfo 端點，確認存取權杖是否已核發給正確的 API 專案，並授予正確的範圍：
```
POST https://www.googleapis.com/oauth2/v2/tokeninfo?access_token={YOUR_ACCESS_TOKEN}

200 OK

{
 "issued_to": "{API_PROJECT_CLIENT_ID}",
 "audience": "...",
 "scope": "{API_SCOPES}",
 "expires_in": ...
}
```

瞭解錯誤

API 遇到錯誤時，通常會傳回含有 error 物件的 JSON 回應。這個物件會提供遇到的特定錯誤的其他背景資訊。

{
 "error": {
  "code": 404,
  "message": "Resource type LINE_ITEM does not exist: advertisers/1/lineItems/1",
  "status": "NOT_FOUND"
 }
}

通常 error 物件的內容會包含足夠的資訊，協助您找出問題所在。如果不是，您可能需要進行額外研究，才能瞭解錯誤的含義。

研究錯誤

請參閱「常見錯誤」一節，其中詳細說明瞭一些最常見的錯誤。
如果常見錯誤一節未涵蓋該錯誤，請參閱參考文件，並嘗試搜尋錯誤代碼、狀態和訊息。
如果您遇到未記錄的錯誤，請通知我們。

找出根本原因

到目前為止，您已找出錯誤並瞭解其含義。如果沒有，請返回「瞭解錯誤」或跳到「取得協助」，因為您可能在 API 中遇到無法自行修正的錯誤。

您必須先找出錯誤原因，才能修正錯誤。這通常是程式碼中的錯誤，或無效的輸入值。

如要判斷問題是否與程式碼中的錯誤有關，請先確認程式碼是否正常運作。首先，請考慮查看導致失敗要求的程式碼部分，檢查是否有明顯問題。在某些情況下，您可能需要使用偵錯工具逐行檢查程式碼，確保程式碼正常運作。

檢查 HTTP 要求是另一種找出潛在錯誤和無效輸入情況的實用方法。許多官方用戶端程式庫都可以設定為記錄 HTTP 要求和回應。如需更多詳細資訊，請參閱所選程式庫的說明文件。您也可以使用 HTTP Proxy (例如 Charles、Squid 或 Fiddler) 擷取要求和回應記錄。取得這些記錄後，請查看記錄，確認應用程式提供的請求參數值正確無誤，且符合預期。

一旦您找出導致錯誤的錯誤或無效輸入內容，修正方式應該就會很明顯。不過，如果您遇到問題或不確定如何解決問題，可以使用目前收集到的資訊，向支援團隊尋求協助。

取得說明

如果您無法自行解決錯誤，可以透過 Display & Video 360 說明中心中的這份表單與支援團隊聯絡。

填寫這份表單時，請盡可能提供您遇到的問題和已採取的疑難排解步驟相關資訊。實用資訊：

HTTP 要求和回應記錄。請務必遮蓋機密資訊，例如 OAuth 2.0 存取權杖、電子郵件地址等。
程式碼片段。如果您能將問題隔離到程式碼的特定部分，或是懷疑問題與語言有關，請附上小片段，說明您正在執行的操作。
其他資訊，例如執行階段/轉譯器版本和平台，這類資訊可能對其他人嘗試重現問題時有所幫助。

修正問題

找出問題原因並提出解決方案後，就可以實施修正。請盡可能在受控環境 (例如專門用於測試的合作夥伴或廣告主) 中測試修正項目，並針對一系列正確和錯誤的輸入內容進行測試，然後再部署至實際環境。