プロモーション管理を移行する

Merchant Promotions API を使用すると、Google でプロモーションを作成して管理できます。accounts.promotions リソースを使用すると、Google で販売する商品のスペシャル オファーを表示できます。詳しくは、Merchant Promotions API の概要をご覧ください。

Content API for Shopping から Merchant API への変更の概要

大きな違いは、Content API for Shopping では最初のプロモーションを挿入するとデータソースが自動的に作成されるのに対し、Merchant API ではそうならないことです。Merchant API を使用してプロモーションを挿入するには、まずプロモーション データソースを作成する必要があります。

accounts.dataSources リソースの promotionDataSource オブジェクトのフィールドについては、PromotionDataSource をご覧ください。

既存のデータソース

既存のデータソースで accounts.dataSources.name がわからない場合は、dataSources.list を使用して取得します。

また、accounts.promotions.get メソッドを使用して、アカウント内の既存のプロモーションのレスポンスで dataSource フィールドを調べ、各プロモーションのデータソースを特定することもできます。

今後の API 呼び出しで直接参照できるように、プロモーションごとに accounts.dataSources.name をローカル データベースに保存することを強くおすすめします。

リクエスト

リクエストを行うには、次の URL を使用します。

POST https://merchantapi.googleapis.com/promotions/v1/{ACCOUNT_NAME}/promotions

Content API for Shopping から移行する

次の表は、プロモーション関連のリクエストについて、Content API for Shopping と Merchant Promotions API を比較したものです。

URL

Content API for Shopping では:

https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/promotions

Merchant API では、次のようになります。

https://merchantapi.googleapis.com/promotions/v1/{parent=accounts/*}/promotions

識別子

Content API for Shopping では:

{MERCHANT_ID}/promotions/{PROMOTION_ID}

Merchant API では、次のようになります。

{NAME}

メソッド

Merchant API は、プロモーションで次のメソッドをサポートしています。

• プロモーションを挿入する
• プロモーションを取得する
• プロモーションを一覧表示する

Content API for Shopping と Merchant API で利用可能なプロモーション方法を比較した表を以下に示します。

フィールドの変更

次の表は、Merchant プロモーション API のプロモーションの変更点を示しています。

参考として例をご覧になるには、accounts.promotions をご覧ください。

{
  "name": "size type", "value": "regular"
}

price:
  {
    object (Price)
  }

price:
  {
    object (Price)
  }

{
  "destinationStatuses": [
    {
      "destination": string,
      "status": enum (State)
    }
  ],
  "promotionIssue": [
    {
    "code": string,
    "detail": string
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string
}

promotionStatus = {
  destinationStatuses = [
     {
     reportingContext = Enum
     status = Enum
     },
  ],
  itemLevelIssues = [
    {
    code = String
    severity = Enum
    resolution = String
    reportingContext = Enum
    description = String
    detail = String
    documentation = String applicableCountries = [
      String,
    ]
    }
  ]
}