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

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

リクエスト

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

POST https://merchantapi.googleapis.com/promotions/v1beta/{account_name}/promotions

Content API for Shopping から移行する

Content API for Shopping と Merchant プロモーションの比較は次のとおりです。 プロモーション関連のリクエスト用の API。

URL

Content API for Shopping の場合:

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

この場合、Merchant API は次のようになります。

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

識別子

Content API for Shopping の場合:

{merchantId}/promotions/{promotionId}

この場合、Merchant API は次のようになります。

{name}

メソッド

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

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

Content API で利用できるプロモーション メソッドの比較は次のとおりです。 ショッピングと Merchant API:

メソッド Content API for Shopping 販売者 API
挿入 ○ ○
入手する ○ ○
リスト ○ ○
customBatch × ×
削除 × （未定）

リソース名

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

参考例は、ローカル インベントリ。

Content API for Shopping 販売者 API 説明
（未対応） custom_attributes カスタム（販売者指定）属性のリスト。Google Chat では
フィードの任意の属性を登録する際にも使用します。
一般的な形式で記述されています。
次に例を示します。 
{
  "name": "size type", "value": "regular"
}
これは、明示的に指定していない属性を送信する場合に便利です。
API で公開されます
サポート対象外 data_source プロモーションを作成するには、既存のデータソースが必要です。
サポート対象外 属性 プロモーション固有の属性（例:
long_tile、promotion_effective_timeperiod、
属性メッセージの一部になります。
item_id item_id_inclusion プロモーションが適用される商品アイテム ID のリスト
to の名前が変更されます。
store_id store_id_inclusion プロモーションが適用される店舗 ID のリスト
名前が変更されます。
prduct_type product_type_inclusion プロモーションが適用される商品カテゴリのリスト
名前が変更されます。
item_group_id item_group_id_inclusion プロモーションが適用される商品グループ ID のリスト
名前が変更されます。
brand brand_inclusion プロモーションが適用されるブランドのリスト
名前が変更されます。
store_code store_codes_inclusion プロモーションが適用される店舗コードのリスト
名前が変更されます。 
price: {
  object (Price)
}

price: {
  object (Price)
}
価格の定義が変更されました。

Content API for Shopping の場合: Price
文字列形式の 10 進数です。

Price の金額がマイクロ単位で記録されるようになりました。
100 万マイクロ秒が現地通貨の
含まれます。

amount フィールド名が value から
amountMicros です。

currency フィールドの名前が次のように変更されました。
currencyCode。形式は
ISO 4217。（ウィキペディア）

order_limit （未対応） order_limit 属性はサポートされていません。
shippingServiceNames[] （未対応） shippingServiceNames[] はサポートされていません。
money_budget （未対応） money_budget はサポートされていません。
promotion_destination_ids promotion_destinations promotionDestinationIds の名前が変更されました。
プロモーションのステータス 
{
  "destinationStatuses": [
    {
      "destination": string,
      "status": enum (State)
    }
  ],
  "promotionIssue": [
    {
    "code": string,
    "detail": string
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string
}
<ph type="x-smartling-placeholder"></ph> [プロモーションのステータス] が変更されました。
さらに詳細な情報は、問題でご確認ください。 
promotionStatus = {
  destinationStatuses = [
     {
     reportingContext = Enum
     status = Enum
     },
  ],
  itemLevelIssues = [
    {
    code = String
    severity = Enum
    resolution = String
    reportingContext = Enum
    description = String
    detail = String
    documentation = String applicableCountries = [
      String,
    ]
    }
  ]
}