設定 Google API 控制台專案

您必須擁有 Google API 控制台專案,才能建立 OAuth 2.0 憑證、設定使用者同意畫面,以及為應用程式啟用 Google Ads API。

Google 伺服器需要憑證才能驗證和授權 Google Ads 使用者。這些憑證可讓您產生 OAuth 憑證,以便用於呼叫 API。

選取或建立 Google API 控制台專案

如果您已有 Google API 控制台專案,並想要使用該專案建立憑證,可以直接跳至「建立用戶端 ID 和用戶端密鑰」一節。

如要建立專案,請按照下列步驟操作:

  • 前往 Google API 控制台
  • 按一下「建立專案」
  • 輸入名稱或接受系統產生的建議
  • 確認或編輯其餘欄位
  • 按一下「Create」(建立)

如果您已啟用計費功能,請選取新專案的帳單帳戶。Google Ads API 不會產生費用,但 Cloud 專案總數有配額。

如果您使用現有的 Google API 控制台專案,並之前已設定 OAuth 同意畫面,可以略過這個步驟,改為加入 Google Ads API OAuth 2.0 範圍來修改同意畫面。

如果您使用 OAuth 2.0 進行授權,Google 會向使用者顯示同意畫面,其中包括專案摘要、政策政策,以及要求的存取授權範圍。設定應用程式的 OAuth 同意畫面會定義使用者和應用程式審查人員看到的內容,並註冊應用程式,方便您日後發布。

  1. 開啟 「同意畫面」頁面,然後在頁面頂端的下拉式選單中選取專案。
  2. 選取「使用者類型」,然後按一下「建立」
  3. 填寫同意畫面表單。您日後可視需求編輯這個名稱。 完成後,請按一下「儲存並繼續」
  4. 在下一頁中,按一下「新增或移除縮圖」
  5. 向下捲動,然後在「手動新增範圍」下方的欄位中輸入下列內容:

    https://www.googleapis.com/auth/adwords

  6. 按一下「新增至資料表」
  7. 新增專案可能需要的任何其他範圍,然後按一下「更新」
  8. 按一下 [儲存並繼續]。
  9. 如果您不打算立即發布專案,請新增您可能用於測試的每個使用者帳戶電子郵件地址,然後按一下 [儲存並繼續]
  10. 查看摘要頁面,然後按一下「返回資訊主頁」
  1. 開啟 「同意畫面」頁面,然後在頁面頂端的下拉式選單中選取專案。
  2. 按一下「編輯應用程式」
  3. 按一下「OAuth 同意畫面」表單中的「儲存並繼續」
  4. 在下一頁中,按一下「新增或移除縮圖」
  5. 向下捲動,然後在「手動新增範圍」下方的欄位中輸入下列內容:

    https://www.googleapis.com/auth/adwords

  6. 按一下「新增至資料表」
  7. 按一下 [儲存並繼續]。
  8. 在「測試使用者」表單上按一下「儲存並繼續」
  9. 查看摘要頁面,然後按一下「返回資訊主頁」

建立用戶端 ID 和用戶端密鑰

如果您使用的是已產生用戶端 ID 和密鑰的現有 Google API 控制台專案,則可以略過這個步驟。

決定應用程式類型後,請按照下列操作說明產生 OAuth 2.0 用戶端 ID 和用戶端密鑰:

  1. 開啟「Credentials」(憑證) 頁面。選取先前建立的專案,或建立新專案。

  2. 在「憑證」畫面上,按一下「建立憑證」,然後選取「OAuth 用戶端 ID」

    • 如果您尚未為這項專案設定 OAuth 同意畫面,請按一下「設定同意畫面」

      • 選取使用者類型,然後按一下「建立」。

      • 填寫初始表單。您日後可視需求編輯這個名稱。完成後,請按一下「Save」(儲存)

    • 返回「Credentials」(憑證) >「CREATE CREDENTIALS」(建立憑證) >「OAuth client ID」(OAuth 用戶端 ID) 以繼續操作。

  3. 根據您的用途,選取「電腦版應用程式」或「網頁應用程式」做為應用程式類型。本指南使用「電腦版應用程式」做為應用程式類型。

  4. 填入應用程式名稱,然後按一下「Create」

  5. 在確認頁面上,將「Your Client ID」(您的用戶端 ID) 與「Your Client Secret」(您的用戶端密鑰) 複製到剪貼簿,以便稍後設定用戶端程式庫。另外,請將 JSON 格式的憑證下載至 credentials.json 檔案。

在專案中啟用 Google Ads API

如要在專案中啟用 Google Ads API,請按照下列步驟操作:

  1. 在 Google API 控制台中開啟 API 程式庫。按照系統說明選取專案,或建立新專案。API 程式庫會列出所有可用的 API,並按照產品系列和熱門程度分組。

  2. 如果 Google Ads API 在清單未列出,請使用搜尋功能。

  3. 選取 Google Ads API,然後點選「啟用」按鈕。