開始使用

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 開發人員說明文件的 API Explorer

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

  3. 在 APIs Explorer 中,確認已在「Authentication」(驗證) 下拉式選單中選取 [Google OAuth 2.0] (Google OAuth 2.0)

  4. 在表單的「父項」欄位中,輸入 accounts/{account_id},將 {account_id} 替換為 Manufacturer Center 帳戶的製造商 ID,然後按一下 [Execute] (執行)

  5. 您應該會看到成功的回應。恭喜!您已提出第一個 Manufacturer Center API 要求。

  6. 如果 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。

  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 程式應完成執行,並列印找到的產品清單,或說明帳戶中沒有產品的訊息。如果出現「使用者無法存取帳戶 1234567890」這類錯誤訊息,很可能是因為您未在 Manufacturer Center 中將服務帳戶使用者設為授權使用者。從 API 的觀點來看,API 控制台專案是代表某位已取得 Manufacturer Center 授權管理員清單的使用者提出要求,因此會拒絕該項要求。

  8. 您可以嘗試執行 ProductsListSample 次,次數不限,因為這是唯讀要求。您也可以探索我們為 Java 和 .NET 所建立的其他範例。