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

Merchant Promotions API を使用すると、Google でプロモーションを作成して管理できます。 accounts.promotions リソースを使用すると、Google で販売する商品のスペシャルオファーを表示できます。 詳しくは、Merchant プロモーション 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,
    ]
    }
  ]
}