Manufacturer Center (MfC) API 可讓應用程式直接與 Manufacturer Center 平台互動。為協助您快速上手,我們提供了 Java 和 .NET 的程式碼範例。
本指南將協助您使用 Manufacturer Center API 建立第一個應用程式。開始寫程式之前,你必須先完成幾件事。
REST 支援
我們的 REST API 針對 2 種不同類型的資源支援基本的 CRUD 作業:
- 品牌擁有者和資料合作夥伴適用的產品。
- 並為認證機構準備ProductCertification。
本文件其餘部分將主要針對 Product 撰寫,但程序在 ProductCertification 方面應十分類似。
設定 Manufacturer Center 帳戶
請務必記下您建立這個 Manufacturer Center 帳戶時使用的電子郵件地址,因為後續步驟將會用到。在螢幕截圖中,您會看到 manufacturer_user@example.com。
發出第一個 API 要求 (不必編寫程式碼!),
請前往
Accounts.Products.list
開發人員說明文件中的 APIs Explorer。確認已登入的 Google 帳戶列在「設定」分頁的「使用者」設定中。
在 API Explorer 中,確認已選取「Authentication」下拉式選單中的「Google OAuth 2.0」:
輸入
accounts/{account_id}
,將{account_id}
替換為 Manufacturer Center 帳戶中的製造商 ID,然後在表單的「parent」欄位內輸入,然後按一下「Execute」。畫面上會顯示成功的回應。恭喜!您已發出第一個 Manufacturer Center API 要求。
如果 Manufacturer Center 中還沒有產品,清單中就不會顯示任何產品。此時,您可以跳轉其他要求,並查看這些要求的運作方式。由於這是符合 REST 樣式的 API,因此所有要求的運作方式都很類似。取得產品後,下一步就是嘗試
Accounts.Products.get
。
建立 Google API 控制台專案
系統會透過您的 API 控制台專案,向 Manufacturer Center API 發出要求。這裡假設您會存取自己的 Manufacturer Center 帳戶,因此建議您使用服務帳戶來簡化驗證流程。請參閱服務帳戶指南,進一步瞭解如何設定新的服務帳戶,以便與 Manufacturer Center 帳戶搭配使用。
您第一個使用 Java 授權的 API 要求
現在您已設定服務帳戶,並將服務帳戶 ID 新增至 Manufacturer Center 帳戶,可使用可用的程式碼範例存取帳戶。本指南使用 Java 範例來示範如何使用 API。
如果您尚未安裝 Apache Maven,請先完成這項作業。
從 GitHub 頁面下載購物範例。
在
java
子目錄中建構 Java 範例:$ mvn compile
接著執行
ProductsListSample
(ProductCertification 的例子為ListProductCertificationsSample
) 程式碼:$ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
如果您尚未按照來源檔案隨附的 README 設定指示進行操作,您會收到找不到範例設定的錯誤訊息。按照 README 中的指示建立設定目錄,並在其中填入適當的資訊。設定服務帳戶時下載的 JSON 檔案,應放在檔案名稱為
service-account.json
的目錄中。請記得設定下列環境變數,向程式碼指出檔案的位置。export GOOGLE_APPLICATION_CREDENTIALS=<Path to your JSON credentials file>
您現在已完成範例設定,請再次執行
ProductsListSample
程式碼。$ mvn exec:java -Dexec.mainClass="shopping.manufacturers.v1.samples.products.ProductsListSample"
此時,Java 程式應已完成執行,並顯示找到的產品清單,或表示帳戶中沒有產品的訊息。如果收到「User cannot access account 1234567890」等錯誤訊息,很可能是因為您尚未在 Manufacturer Center 中將服務帳戶使用者設為授權使用者。從 API 的觀點來看,API 控制台專案代表不在 Manufacturer Center 授權管理員清單中的使用者傳送要求,因此當然也會拒絕該要求。
ProductsListSample
是唯讀要求,因此可以多次執行實驗,次數不限。也可以探索我們為 Java 和 .NET 建立的其他範例。