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 API Explorer 运行 Merchant API 请求。API 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 界面查看此产品。