開始使用

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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

本指南可協助您使用 Manufacturer Center API 建立第一個應用程式。開始撰寫程式碼前，您必須先完成幾個步驟。

設定 Manufacturer Center 帳戶

  1. 建立 Manufacturer Center 帳戶。
  2. 請記住，您用於建立這個 Manufacturer Center 帳戶的電子郵件，稍後將會用到。在螢幕截圖中，您看到的是 manufacturer_user@example.com。

發出第一個 API 要求 (無需編寫程式碼！)

  1. 請前往 Accounts.Products.list 開發人員說明文件的 API 探索工具。

  2. 確認 [設定] 分頁中已登入的 Google 帳戶，會顯示在「#39;使用者'」設定中。

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

  4. 在「##9;parent'」欄位中，輸入 accounts/{account_id}，並以 Manufacturer Center 帳戶的製造商 ID 取代「{account_id}」，然後按一下表單中的「執行」。

    注意：如果您先前未授予 OAuth2 權限，系統會要求您授權呼叫。

  5. 您應該會看到成功的回應。恭喜！您已提出第一個 Manufacturer Center API 要求。
  6. 如果 Manufacturer Center 中還沒有任何產品，清單中就不會顯示任何產品。 這時您可以跳轉至其他要求並查看其操作。由於這是符合 REST 樣式的 API，因此所有要求的運作方式都類似。準備好產品之後，請試試 Accounts.Products.get。

建立 Google API 控制台專案

您可以透過 Manufacturer Center 專案提出 Manufacturer Center API 要求。我們假設您要存取自己的 Manufacturer Center 帳戶，因此建議使用服務帳戶來簡化驗證流程。請參閱服務帳戶指南，進一步瞭解如何設定與 Manufacturer Center 帳戶搭配使用的新服務帳戶。

注意事項：如想代表自家 Manufacturer Center 帳戶的客戶撥打電話，請參閱授權要求指南。

您的第一個 Java 授權 API 要求

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

  1. 安裝 Apache Maven (如果您尚未這麼做)。

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

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

    $ mvn compile

  4. 接著，執行 ProductsListSample 程式碼： 

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

  5. 如果您尚未按照來源檔案中的 README 中的設定指示完成操作，就會收到錯誤訊息，找不到找不到的樣本設定。按照 README 中的指示建立設定目錄，並填入適當的資訊。您在設定服務帳戶時下載的 JSON 檔案，應置於檔案名稱為 service-account.json 的目錄中。

  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 所建立的其他範例。