開始使用

Manufacturer Center (MfC) API 可讓應用程式直接與 Manufacturer Center 平台互動。為協助您快速上手，我們提供了 Java 和 .NET 的程式碼範例。

本指南將協助您使用 Manufacturer Center API 建立第一個應用程式。開始寫程式之前，你必須先完成幾件事。

REST 支援

我們的 REST API 針對 2 種不同類型的資源支援基本的 CRUD 作業：

本文件其餘部分將主要針對 Product 撰寫，但程序在 ProductCertification 方面應十分類似。

設定 Manufacturer Center 帳戶

  1. 建立 Manufacturer Center 帳戶。

  2. 請務必記下您建立這個 Manufacturer Center 帳戶時使用的電子郵件地址，因為後續步驟將會用到。在螢幕截圖中，您會看到 manufacturer_user@example.com。

發出第一個 API 要求 (不必編寫程式碼！)，

  1. 請前往 Accounts.Products.list 開發人員說明文件中的 APIs Explorer。

  2. 確認已登入的 Google 帳戶列在「設定」分頁的「使用者」設定中。

  3. 在 API Explorer 中，確認已選取「Authentication」下拉式選單中的「Google OAuth 2.0」：

  4. 輸入 accounts/{account_id}，將 {account_id} 替換為 Manufacturer Center 帳戶中的製造商 ID，然後在表單的「parent」欄位內輸入，然後按一下「Execute」。

  5. 畫面上會顯示成功的回應。恭喜！您已發出第一個 Manufacturer Center API 要求。

  6. 如果 Manufacturer Center 中還沒有產品，清單中就不會顯示任何產品。此時，您可以跳轉其他要求，並查看這些要求的運作方式。由於這是符合 REST 樣式的 API，因此所有要求的運作方式都很類似。取得產品後，下一步就是嘗試 Accounts.Products.get。

建立 Google API 控制台專案

系統會透過您的 API 控制台專案，向 Manufacturer Center API 發出要求。這裡假設您會存取自己的 Manufacturer Center 帳戶，因此建議您使用服務帳戶來簡化驗證流程。請參閱服務帳戶指南，進一步瞭解如何設定新的服務帳戶，以便與 Manufacturer Center 帳戶搭配使用。

您第一個使用 Java 授權的 API 要求

現在您已設定服務帳戶，並將服務帳戶 ID 新增至 Manufacturer Center 帳戶，可使用可用的程式碼範例存取帳戶。本指南使用 Java 範例來示範如何使用 API。

  1. 如果您尚未安裝 Apache Maven，請先完成這項作業。

  2. 從 GitHub 頁面下載購物範例。

  3. 在 java 子目錄中建構 Java 範例：

    $ mvn compile

  4. 接著執行 ProductsListSample (ProductCertification 的例子為 ListProductCertificationsSample) 程式碼：

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"

  5. 如果您尚未按照來源檔案隨附的 README 設定指示進行操作，您會收到找不到範例設定的錯誤訊息。按照 README 中的指示建立設定目錄，並在其中填入適當的資訊。設定服務帳戶時下載的 JSON 檔案，應放在檔案名稱為 service-account.json 的目錄中。請記得設定下列環境變數，向程式碼指出檔案的位置。

    export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>

  6. 您現在已完成範例設定，請再次執行 ProductsListSample 程式碼。

    $ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"

  7. 此時，Java 程式應已完成執行，並顯示找到的產品清單，或表示帳戶中沒有產品的訊息。如果收到「User cannot access account 1234567890」等錯誤訊息，很可能是因為您尚未在 Manufacturer Center 中將服務帳戶使用者設為授權使用者。從 API 的觀點來看，API 控制台專案代表不在 Manufacturer Center 授權管理員清單中的使用者傳送要求，因此當然也會拒絕該要求。

  8. ProductsListSample 是唯讀要求，因此可以多次執行實驗，次數不限。也可以探索我們為 Java 和 .NET 建立的其他範例。