本頁面由 Cloud Translation API 翻譯而成。

開始使用 Merchant API

本頁面說明如何建立 Merchant Center 帳戶，並使用 Merchant API 上傳產品範例。

事前準備

在 Google Cloud 專案中啟用 Merchant API。

前往 Google Cloud

建立帳戶

如要使用 Merchant API，你必須擁有 Merchant Center 帳戶。如要建立 Merchant Center 帳戶，請參閱「開始使用 Merchant Center」。

前往 Merchant Center

取得帳戶 ID

您可以使用 accounts.list 方法取得帳戶 ID。

您可以使用 Google APIs Explorer 執行 Merchant API 要求。APIs Explorer 會使用 Google OAuth 2.0 進行驗證。執行要求前，請確認已勾選「Google OAuth 2.0」核取方塊。

如要使用 OAuth 2.0 驗證，您必須登入 Google 帳戶，然後登入 API Explorer。你也必須允許 API Explorer 管理產品資訊和帳戶。

以下要求說明如何擷取帳戶 ID：

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts

要求執行成功後，您會看到下列回應：

{
  "accounts": [
    {
      "name": "{ACCOUNT_NAME}",
      "accountId": "{ACCOUNT_ID}",
      "accountName": "{ACCOUNT_DISPLAY_NAME}",
      "timeZone": {
        "id": "America/Los_Angeles"
      },
      "languageCode": "en-US"
    }
  ]
}

請複製 {ACCOUNT_ID}，因為您需要它來執行其他要求。

建立主要產品資料來源

如要插入產品，你需要主要產品資料來源。以下要求顯示如何建立資料來源，以便在帳戶中插入產品：

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources HTTP/1.1

{
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "feedLabel": "US"
  },
  "name": "primary-data-source",
  "displayName": "Primary Products Data Source"
}

將 {ACCOUNT_ID} 替換為您建立的 Merchant Center 帳戶 ID。

這項要求執行成功後，您會看到下列回應：

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
  "dataSourceId": "{DATASOURCE_ID}",
  "displayName": "Primary Products Data Source",
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "feedLabel": "US",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

請複製 name 欄位的值，因為您需要該值插入產品。

建立的資料來源需要幾分鐘的時間才能插入產品。

你可以在 Merchant Center 使用者介面中查看這項資料來源。詳情請參閱「如何找到『資料來源』分頁」。

插入一項產品

如要將產品範例插入帳戶，請執行下列要求：

POST https://merchantapi.googleapis.com/products/v1beta/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1

{
  "channel": "ONLINE",
  "contentLanguage": "en",
  "feedLabel": "US",
  "name": "Red T-shirt",
  "attributes": {
    "gender": "Male",
    "brand": "New brand"
  },
  "offerId": "tshirt-123"
}

將 {DATASOURCE_NAME} 替換為先前複製的值。

這項要求執行成功後，您會看到下列回應：

{
  "name": "accounts/{ACCOUNT_ID}/productInputs/online~en~US~tshirt-123",
  "product": "accounts/{ACCOUNT_ID}/products/online~en~US~tshirt-123",
  "channel": "ONLINE",
  "offerId": "tshirt-123",
  "contentLanguage": "en",
  "feedLabel": "US",
  "attributes": {
    "brand": "New brand",
    "gender": "Male"
  }
}

新建產品的產品 ID 為 online~en~US~tshirt-123。您可以使用 accounts.products.get 方法擷取此產品的詳細資料。你也可以使用 Merchant Center UI 查看這項產品。

服務上線狀態

總覽