Merchant API を使ってみる

このページでは、Merchant API を使用して Merchant Center アカウントを作成し、サンプル商品をアップロードする方法について説明します。

始める前に

Google Cloud プロジェクトで Merchant API を有効にします。

Google Cloud に移動

アカウントを作成する

Merchant API を使用するには、Merchant Center アカウントが必要です。Merchant Center アカウントを作成するには、Merchant Center の利用を開始するをご覧ください。

Merchant Center に移動

アカウント ID を取得する

アカウント ID は accounts.list メソッドを使用して取得できます。

Google APIs 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 の UI で確認できます。詳細については、[データソース] タブを表示する方法をご覧ください。

商品を挿入する

アカウントにサンプル商品を挿入するには、次のリクエストを実行します。

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 を使用してこのプロダクトを表示することもできます。

前へ
起動ステータス
次へ
概要