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
Price の金額がマイクロ単位で記録されるようになりました。
amount フィールド名が value から
currency フィールドの名前が次のように変更されました。
|
| 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,
]
}
]
}
|
|