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

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 をご覧ください。

リクエスト

リクエストを行うには、次の 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 Promotions API のプロモーションの変更点を示します。

参考として例を確認するには、ローカル在庫をご覧ください。

{
  "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,
    ]
    }
  ]
}