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
開發人員說明文件的 API Explorer。確認已登入的 Google 帳戶列於 [設定] 分頁的「使用者」設定中。
在 APIs Explorer 中,確認已在「Authentication」(驗證) 下拉式選單中選取 [Google OAuth 2.0] (Google OAuth 2.0):
在表單的「父項」欄位中,輸入
accounts/{account_id}
,將{account_id}
替換為 Manufacturer Center 帳戶的製造商 ID,然後按一下 [Execute] (執行)。您應該會看到成功的回應。恭喜!您已提出第一個 Manufacturer Center API 要求。
如果 Manufacturer Center 中還沒有任何產品,清單中就不會顯示任何產品。這時您可以跳轉至其他要求並查看其操作。由於這是符合 REST 樣式的 API,所有要求的運作方式都相同。當您擁有產品之後,下一步就是嘗試
Accounts.Products.get
。
建立 Google API 控制台專案
您可以透過 Manufacturer Center 專案提出 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 程式應完成執行,並列印找到的產品清單,或說明帳戶中沒有產品的訊息。如果出現「使用者無法存取帳戶 1234567890」這類錯誤訊息,很可能是因為您未在 Manufacturer Center 中將服務帳戶使用者設為授權使用者。從 API 的觀點來看,API 控制台專案是代表某位已取得 Manufacturer Center 授權管理員清單的使用者提出要求,因此會拒絕該項要求。
您可以嘗試執行
ProductsListSample
次,次數不限,因為這是唯讀要求。您也可以探索我們為 Java 和 .NET 所建立的其他範例。