設定用戶端程式庫

歡迎使用 Merchant API (Beta 版)，這是購物專用 Content API 的正式後繼者。

取得最新 Merchant API (Beta 版) 的最新功能、錯誤修正和發布更新。

瞭解如何在 Google 上管理商家和產品，以及如何透過程式輔助方式存取大量資料、洞察資料和獨特功能。立即開始

建議您使用 Google API 用戶端程式庫設定 Content API for Shopping。本指南以 Python Content API 用戶端程式庫為例，但這些程式庫可用於許多熱門的程式設計語言，並簡化常見的 API 工作，例如驗證、傳送要求和剖析回應。如需其他語言的用戶端程式庫設定說明，請參閱 GitHub 上 googleads/googleads-shopping-samples 存放區中該語言的 README.md 檔案。

注意： 您必須安裝幾個必要的程式庫，才能在 Python 中使用範例程式碼。因此，建議您在繼續操作前建立 Python 虛擬環境。詳情請參閱「使用 pip 和虛擬環境安裝套件」一文。

如要設定 Python 適用的 Google API 用戶端程式庫，請完成下列步驟：

1. 建立用戶端程式庫設定和驗證檔案的目錄。在主目錄中建立以下目錄：

   ~/shopping-samples/content/

   注意： 這個路徑以及在步驟 5 中建立的 merchant-info.json 檔案的檔案名稱，皆已在步驟 7 下載的 Content API 範例目錄中定義的 python/shopping/content/common.py 檔案中定義。

2. 如要下載服務帳戶憑證，請完成下列步驟：

   1. 前往 Google API 程式庫。
   2. 在頁面頂端的選單中選取專案。如果您還沒有專案，請按一下「New project」建立專案。
   3. 如果您尚未為這個專案啟用 Content API for Shopping，請在 Google API 清單中搜尋並啟用該 API。
   4. 在左側欄中選取「憑證」。您可能需要按一下左上方的左向箭頭，才能查看這項資訊。
   5. 如要設定服務帳戶，請依序選取「建立憑證」和「服務帳戶」。
   6. 為新服務帳戶命名。這也是服務帳戶 ID 的預設使用者名稱。記下服務帳戶 ID (包括「@」字元後的部分)，以便日後使用。按一下「建立」，然後依序完成選用步驟 (授予專案和使用者存取權)，然後按一下「完成」。
   7. 系統會將您導向「Service Accounts」(服務帳戶) 頁面，您可以在該頁面存取新的服務帳戶。

3. 如要取得 JSON 私密金鑰，請按一下服務帳戶，然後點選「金鑰」分頁。依序點選「新增金鑰」 >「建立新金鑰」，然後選取 JSON 做為金鑰類型。按一下「Create」，將私密金鑰下載到電腦。系統會自動下載新金鑰。

4. 將下載的憑證檔案重新命名為 service-account.json。

   注意： 這個檔案名稱是在 _constants.py 檔案中定義，該檔案位於在步驟 7 下載的 Content API 範例目錄中的 python/shopping/content/ 中。

5. 將 service-account.json 檔案移至 home directory/shopping-samples/content/。

6. 在 home directory/shopping-samples/content/ 中建立空白的 merchant-info.json 檔案。

7. 在 merchant-info.json 中加入以下文字：

   {
   "merchantId": your Merchant Center merchant ID,
   "accountSampleUser": "the email address associated with your Merchant Center account"
   }
   

8. 將新的服務帳戶新增為 Merchant Center 帳戶使用者。如果您是第三方開發人員，則需要請客戶為您執行這個步驟。

   1. 前往 Merchant Center 帳戶。
   2. 在 Merchant Center 帳戶的設定中，選取「使用者與存取權」。

   3. 按一下「+ 新增使用者」，並使用服務帳戶 ID 做為新使用者的電子郵件地址。

      注意： 如果您先前沒有記下服務帳戶 ID，請前往服務帳戶管理頁面，然後選取您建立的專案。

   4. 使用 Accounts 服務需要管理員存取權，因此請選取「管理員」。

   5. 按一下「新增使用者」，儲存偏好設定並返回使用者清單。服務帳戶 ID 會與所選使用者角色一併列出。

   6. 針對要新增的所有其他服務帳戶重複執行上述步驟。

9. 將 googleads/googleads-shopping-samples GitHub 存放區複製 (或下載並解壓縮) 到電腦上的任何位置，不必放在家目錄或 ~/shopping-samples/content/ 中。

10. 如果您下載並解壓縮存放區，而非複製存放區，請將解壓縮的目錄重新命名為 googleads-shopping-samples。

11. 如要安裝必要的範例依附元件，請在終端機視窗中前往 googleads-shopping-samples/python/，然後執行以下指令：

    pip install -r requirements.txt
    

您現在已設定 Python 適用的 Google API 用戶端程式庫，並準備好搭配 Content API 使用。在下一節中，您將建立並傳送要求，插入新產品。