設定 Google API 控制台專案

重點： 進行第一次 API 呼叫時，必須先使用 OAuth 2.0 用戶端 ID 和用戶端密鑰。建立這些項目後，請務必記下這些事件的值，以便在後續步驟中使用。

您需要 Google API 控制台專案，才能建立 OAuth 2.0 憑證、設定使用者同意畫面，並為應用程式啟用 Google Ads API。

Google 伺服器需要憑證，才能驗證和授權 Google Ads 使用者。這些憑證可產生用於呼叫 API 的 OAuth 權杖。

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

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

如要建立專案，請按照下列步驟操作：

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

如已啟用計費功能，請選取新專案的帳單帳戶。 Google Ads API 不會收費，但 Cloud 專案總數設有配額。

設定 OAuth 同意畫面

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

當您使用 OAuth 2.0 進行授權時，Google 會向使用者顯示同意畫面，包括專案摘要、專案政策，以及要求的存取權範圍。設定應用程式的 OAuth 同意畫面，會定義向使用者和應用程式審查者顯示的內容，並註冊應用程式以供日後發布。

設定新的 OAuth 同意畫面

1. 開啟 「Consent Screen」(同意畫面) 頁面，並在頁面頂端的下拉式選單中選取您的專案。
2. 選取「使用者類型」，然後按一下「建立」。
3. 填寫同意畫面表單。日後如有需要，也可以編輯這項資訊。 完成後，按一下「儲存並繼續」。
4. 在下一頁中，按一下「新增或移除留言」。
5. 向下捲動，然後在「手動新增範圍」下方的欄位中輸入下列內容：

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

6. 按一下「新增至表格」。
7. 新增專案可能需要的任何其他範圍，然後按一下「更新」。
8. 按一下 [儲存並繼續]。
9. 如果您不打算立即發布專案，請新增可能用於測試的每個使用者帳戶的電子郵件地址，然後按一下 [儲存並繼續]。
10. 查看摘要頁面，然後按一下「返回資訊主頁」。

設定現有的 OAuth 同意畫面

1. 開啟 「同意畫面」頁面，然後在頁面頂端的下拉式選單中選取專案。
2. 按一下「編輯應用程式」。
3. 在「OAuth 同意畫面」表單中，按一下「儲存並繼續」。
4. 在下一頁中，按一下「新增或移除留言」。
5. 向下捲動，然後在「手動新增範圍」下方的欄位中輸入下列內容：

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

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

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

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

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

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

2. 在「憑證」畫面上，按一下「建立 CREDENTIALS」，然後選取「OAuth client ID」。

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

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

     • 填寫初始表單。日後如有需要，仍可修改這項資訊。完成後，請按一下「Save」(儲存)。

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

3. 根據您的用途，選取「Desktop app」或「Web application」做為應用程式類型。本指南使用電腦版應用程式做為應用程式類型。

4. 填寫應用程式的名稱，然後按一下「建立」。

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 在清單中找不到，請使用搜尋來找出該 API。

3. 選取 Google Ads API，然後按一下「啟用」按鈕。