DV360 Exchange Reporting API 新手上路和 OAuth 設定

DV360 Exchange Reporting API 可讓第三方交易平台 (3PE) 合作夥伴，以程式輔助方式存取 Display & Video 360 的成效報表。

DV360 Exchange Reporting API 是以許可清單為基礎的 Google Cloud API，使用 OAuth。許可清單程序由 DV360 Exchange Reporting API 團隊處理。

程序

以下是 DV360 廣告交易平台 Reporting API 的導入步驟：

  1. 在 Google Cloud 控制台註冊 Google 帳戶。

    請注意，這個帳戶是用來管理生產環境用戶端的存取權杖，因此請勿使用個人 Gmail 帳戶。

  2. 請向 Google DV360 提供帳戶資訊，以便將帳戶新增至允許清單。

  3. 收到已加入許可清單的通知後，請申請 OAuth 驗證審查，讓應用程式取得 doubleclickbidmanager 範圍的存取權。

  4. 登入 Google Cloud 控制台。

    依序前往「API 和服務」>「程式庫」>「私人」。您應該會看到 DV360 廣告交易平台報表 API 列為可用的 API 之一。啟用 DV360 Exchange Reporting API。

  5. 依序前往「憑證」>「建立憑證」>「服務帳戶金鑰」。按照操作說明建立服務帳戶。

服務帳戶

服務帳戶可讓您的程式碼將應用程式憑證直接傳送給 API。服務帳戶 (如同使用者帳戶) 是以電子郵件地址表示。但與使用者帳戶不同的是，服務帳戶只屬於應用程式，只能用來存取專為該應用程式而建立的 API。

以下說明如何使用 Google Cloud 控制台建立服務帳戶憑證：

  1. 在「API 管理員」>「憑證」頁面中，選取「建立憑證」→「服務帳戶金鑰」。

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

    輸入這個服務帳戶的「名稱」。這個名稱會做為「服務帳戶 ID」的預設名稱 (在產生的服務帳戶 ID 位址中「@」符號左邊的部分)。@

    在「金鑰類型」下方，建議您將這個值保留為 JSON。按一下「建立」，產生 JSON 金鑰 (以 .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>api@project-id.iam.gserviceaccount.com",
  "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"
}

  3. 請妥善儲存 JSON 檔案，因為這個檔案含有您的私密金鑰，且是該金鑰的唯一副本。程式碼呼叫 API 時，需要使用這個檔案中的憑證。

  4. 請將您建立的服務帳戶資訊 (具體來說是服務帳戶的電子郵件地址) 提供給 DV360。這是 API 存取權許可清單程序的一部分。

存取權杖

服務帳戶獲得呼叫 API 的授權後，即可繼續使用 API 指南中的範例。如要手動取得存取權杖，可以使用 oauth2l 等工具，或是使用我們的用戶端程式庫，以程式輔助方式進行驗證。