設定驗證功能

DV360 賣家 API 新手上路

如要為 DV360 賣家 API 啟用 API，您必須完成幾個主要步驟。DV360 Seller API 會以允許清單為基礎的 Google Cloud API 公開，並使用 OAuth 進行驗證。

如要進行許可清單程序，請與 DV360 賣家 API 團隊聯絡。

注意：如果應用程式存取 DV360 Seller API，則必須通過 OAuth 驗證審查。如果測試應用程式時，畫面上顯示「未經驗證的應用程式」，您必須提交驗證要求才能移除。進一步瞭解未經驗證的應用程式，或參閱應用程式驗證常見問題的解答。

加入步驟：

1. 前往 https://console.cloud.google.com/ 註冊 Google 帳戶。
   • 這個帳戶將用於管理實際工作環境用戶端的存取權權杖。請勿使用個人 Gmail 帳戶。
   • 帳戶不得是 Google 群組。
   • 如果您使用的是現有的 Google Cloud 專案：帳戶必須是專案的管理員。
2. 請與 Google DV360 聯絡，並提供您註冊的帳戶資訊，以便將帳戶新增至許可清單。
3. 等候帳戶加入允許清單。
4. 選用且非阻斷：為應用程式提交 OAuth 驗證審查要求，以便存取範圍(doubleclickbidmanager)。
5. 前往 https://console.cloud.google.com/。依序前往「API 和服務」->「程式庫」->「私人」。您應該會看到 DV360 Seller API 列為可用的 API 之一。
6. 啟用 DV360 Seller API
7. 依序前往「憑證」->「建立憑證」->「服務帳戶金鑰」。請按照這裡的說明操作：https://developers.google.com/identity/protocols/OAuth2ServiceAccount

   設定服務帳戶：

   注意：如果您想重複使用現有的服務帳戶 (例如 DV360 Reporting API)，請告知我們。

   Google Cloud API 驗證和授權 (通常合稱「驗證」) 一般是透過服務帳戶執行。服務帳戶可讓您的程式碼將應用程式憑證直接傳送給 Cloud API。服務帳戶 (如同使用者帳戶) 是以電子郵件地址表示。但與使用者帳戶不同的是，服務帳戶只屬於應用程式，只能用來存取專為該應用程式而建立的 API。舉例來說，以下將示範如何使用 Google Cloud Platform 主控台建立服務帳戶憑證。

   使用 Google Cloud Console

   在 Google Cloud 控制台的「API Manager」→「Credentials」頁面中，選取「Create credentials」→「Service account key」。

   

   接著從「Service account」(服務帳戶) 下拉式選單選取「New service account」(新增服務帳戶)。

   

   為這個服務帳戶輸入「Name」(名稱)。這個名稱將用做「服務帳戶 ID」的預設名稱 (在產生的服務帳戶 ID 位址中「@」符號左邊的部分)，但您可以視需要變更這個服務帳戶 ID 名稱。您可以任意指定這些名稱，只要方便記憶就好。在「Key type」(金鑰類型) 下方，建議您將這個值保留為「JSON」。按一下「Create」(建立)，GCP 主控台將產生 JSON 金鑰 (以 .json 文字檔保存)，提示您將檔案下載至電腦，並顯示「Service account created」對話方塊。

   

   產生的 JSON 金鑰會與下列 JSON 金鑰範例類似：

   {
     "type": "service_account",
     "project_id": "project-id",
     "private_key_id": "some_number",
     "private_key": "-----BEGIN PRIVATE KEY-----\n....
     =\n-----END PRIVATE KEY-----\n",
     "client_email": "<api-name>[e-mail]",
     "client_id": "...",
     "auth_uri": "https://accounts.google.com/o/oauth2/auth",
     "token_uri": "https://accounts.google.com/o/oauth2/token",
     "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
     "client_x509_cert_url": "https://www.googleapis.com/...<api-name>api%40project-id.iam.gserviceaccount.com"
   }

   請儲存 JSON 檔案並提供安全保護，因為這個檔案含有您的私密金鑰 (且這個檔案是該金鑰的唯一副本)。當您要將憑證傳送至 Google Cloud Platform API 時，必須在程式碼中參照這個服務帳戶金鑰檔案。

8. 請提供您建立的 服務帳戶 資訊，與 DV360 聯絡。具體來說，我們需要這個服務帳戶的電子郵件地址。這是另一個授權的許可清單程序。
9. 服務帳戶獲得呼叫 API 的授權後，您可以參閱 https://developers.google.com/display-video/seller 的 API 說明文件。如要手動取得驗證權杖，請參閱以下操作說明：https://github.com/google/oauth2l。(您必須先下載服務帳戶金鑰的 JSON 版本)。如需以程式輔助方式取得 Oauth 權杖的詳細操作說明，請前往：https://cloud.google.com/docs/authentication/production。

重要事項：OAuth 範圍必須是「doubleclickbidmanager」