設定用戶端程式庫

建議使用 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 清單中搜尋並啟用。
   4. 在左側邊欄中選取「憑證」。如要查看這個畫面，可能需要按一下左上方的向左箭頭。
   5. 如要設定服務帳戶，請選取「建立憑證」，然後選取「服務帳戶」。
   6. 為新服務帳戶命名。這也會做為服務帳戶 ID 的預設使用者名稱。請記下服務帳戶 ID，包括「@」字元後的部分，以供日後使用。按一下「建立」，然後完成授予專案和使用者存取權的選用步驟，並點選「完成」。
   7. 系統會將您導向「服務帳戶」頁面，您可以在該頁面存取新的服務帳戶。

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

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 使用。在下一節中，您將建立並傳送要求，插入新產品。