Package google.shopping.merchant.promotions.v1beta

索引

PromotionsService

商品のプロモーションを管理するためのサービス。

GetPromotion

rpc GetPromotion(GetPromotionRequest) returns (Promotion)

Merchant Center アカウントからプロモーションを取得します。

プロモーションの入力を挿入または更新した後、更新されたプロモーションを取得できるようになるまでに数分かかることがあります。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/content

詳しくは、OAuth 2.0 の概要をご覧ください。
InsertPromotion

rpc InsertPromotion(InsertPromotionRequest) returns (Promotion)

Merchant Center アカウントのプロモーションを挿入します。プロモーションがすでに存在する場合は、代わりにプロモーションが更新されます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/content

詳しくは、OAuth 2.0 の概要をご覧ください。
ListPromotions

rpc ListPromotions(ListPromotionsRequest) returns (ListPromotionsResponse)

Merchant Center アカウントのプロモーションが一覧表示されます。レスポンスに含まれるアイテムが pageSize で指定された数よりも少ない場合があります。pageToken を使用して、他にもリクエストする項目があるかどうかを判断します。

プロモーションを挿入または更新した後、更新された処理済みのプロモーションを取得できるようになるまでに数分かかることがあります。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/content

詳しくは、OAuth 2.0 の概要をご覧ください。

属性

属性。

フィールド
product_applicability

ProductApplicability

必須。すべての商品または特定の商品のみにプロモーションを適用するかどうか。
offer_type

OfferType

必須。プロモーションのタイプ。この属性を使用して、プロモーションを利用する際にクーポンコードが必要かどうかを指定します。
generic_redemption_code

string

省略可。プロモーションの汎用適用コード。offerType フィールドとともに使用します。最小要件を満たしている必要があります。
long_title

string

必須。プロモーションの長いタイトル。
coupon_value_type

CouponValueType

必須。実施しているプロモーションのタイプを示す coupon value type 属性。選択したクーポンの値の種類に応じて、いくつかの属性が必須です。
promotion_destinations[]

DestinationEnum

必須。プロモーションが適用される掲載先のリスト。データソースにサポートされている値を含めて掲載先を指定しない場合は、プロモーションがショッピング広告と無料リスティングにデフォルトで表示されます。

商品の掲載先として、ショッピング アクション、Google 掲載、ローカル情報 Google 掲載の値を以前に送信していた可能性があります。これらの値を表すには、FREE_LISTINGS、FREE_LOCAL_LISTINGS、LOCAL_INVENTORY_ADS を使用します。詳しくは、プロモーションの掲載先をご覧ください。
item_id_inclusion[]

string

省略可。プロモーションの商品アイテム ID で商品をフィルタ。商品フィルタ属性は、プロモーションの対象商品の product_applicability 属性が specific_products に設定されている場合にのみ適用されます。
brand_inclusion[]

string

省略可。プロモーションのブランドで商品をフィルタします。商品フィルタ属性は、プロモーションの対象商品の product_applicability 属性が specific_products に設定されている場合にのみ適用されます。
item_group_id_inclusion[]

string

省略可。プロモーションの商品グループ ID で商品をフィルタ。商品フィルタ属性は、プロモーションの対象商品 [product_applicability] 属性が specific_products に設定されている場合にのみ適用されます。
product_type_inclusion[]

string

省略可。プロモーションの商品カテゴリで商品をフィルタします。商品フィルタ属性は、プロモーションの対象商品の product_applicability 属性が specific_products に設定されている場合にのみ適用されます。
item_id_exclusion[]

string

省略可。プロモーションの商品アイテム ID の除外で商品をフィルタします。商品フィルタ属性は、プロモーションの対象商品の product_applicability 属性が specific_products に設定されている場合にのみ適用されます。
brand_exclusion[]

string

省略可。プロモーションのブランドの除外で商品をフィルタします。商品フィルタ属性は、プロモーションの対象商品の product_applicability 属性が specific_products に設定されている場合にのみ適用されます。
item_group_id_exclusion[]

string

省略可。商品グループ ID で商品フィルタ。商品フィルタ属性は、プロモーションの対象商品の product_applicability 属性が specific_products に設定されている場合にのみ適用されます。
product_type_exclusion[]

string

省略可。プロモーションの商品カテゴリの除外で商品をフィルタします。商品フィルタ属性は、プロモーションの対象商品の product_applicability 属性が specific_products に設定されている場合にのみ適用されます。
minimum_purchase_amount

Price

省略可。プロモーションの最小購入金額。
minimum_purchase_quantity

int64

省略可。プロモーションの最小購入数量。
limit_quantity

int64

省略可。プロモーションの購入数の最大値。
limit_value

Price

省略可。プロモーションの商品価格の上限。
percent_off

int64

省略可。プロモーションで提供される割引率。
money_off_amount

Price

省略可。プロモーションで提供される割引額。
get_this_quantity_discounted

int64

省略可。プロモーションで割引されるアイテムの数。この属性は、couponValueType が buy_m_get_n_money_off または buy_m_get_n_percent_off と等しい場合に設定されます。
free_gift_value

Price

省略可。プロモーションのプレゼント価値。
free_gift_description

string

省略可。プロモーションのプレゼントの説明。
free_gift_item_id

string

省略可。プロモーションのプレゼント アイテム ID。
promotion_effective_time_period

Interval

必須。プロモーションの有効期間の TimePeriod 表現。この属性は、この期間にオンライン ショップでプロモーションをテストできることを指定します。
promotion_display_time_period

Interval

省略可。プロモーションの表示期間を表す TimePeriod です。この属性では、Google.com とショッピング広告でプロモーションが公開される日時を指定します。プロモーションの表示期間 promotion_display_time_period 属性が指定されていない場合、プロモーションの有効期間 promotion_effective_time_period によって、Google.com とショッピング広告でプロモーションが公開される期間が決まります。
store_applicability

StoreApplicability

省略可。プロモーションをすべての店舗に適用するか、指定した店舗のみに適用するか。対象店舗が指定されていない場合、ローカル在庫広告のプロモーションでエラーがスローされます。store_applicability が ALL_STORES に設定され、store_codes_inclusion または score_code_exclusion が値に設定されている場合、INVALID_ARGUMENT エラーがスローされます。
store_codes_inclusion[]

string

省略可。プロモーションの含める店舗コード。店舗のフィルタ属性は、store_applicability 属性が specific_stores に設定されている場合にのみ適用されます。

商品を販売している実店舗の店舗コード（ビジネス プロフィールの店舗 ID）。詳しくは、ローカル商品在庫データの仕様をご覧ください。
store_codes_exclusion[]

string

省略可。プロモーションで除外する店舗コード。店舗のフィルタ属性は、store_applicability 属性が specific_stores に設定されている場合にのみ適用されます。
promotion_url

string

省略可。プロモーションが表示される販売者のサイトのページの URL。promotion_url が含まれていない場合、ローカル在庫広告のプロモーションでエラーがスローされます。URL は、プロモーションが有効であり、利用できることを確認するために使用されます。

CouponValueType

プロモーションのクーポンの値タイプ。

列挙型
COUPON_VALUE_TYPE_UNSPECIFIED クーポンの値タイプが指定されていないことを示します。
MONEY_OFF 割引クーポンの値タイプ。
PERCENT_OFF 割引率クーポンの値タイプ。
BUY_M_GET_N_MONEY_OFF M 個購入で N 個割引のクーポンの価値タイプ。minimum_purchase_quantity と get_this_quantity_discounted を指定する必要があります。money_off_amount も指定する必要があります。
BUY_M_GET_N_PERCENT_OFF M 個購入で N% 割引のクーポンの値タイプを指定します。minimum_purchase_quantity と get_this_quantity_discounted を指定する必要があります。percent_off_percentage も指定する必要があります。
BUY_M_GET_MONEY_OFF M 個購入で割引が適用されます。minimum_purchase_quantity と money_off_amount を指定する必要があります。
BUY_M_GET_PERCENT_OFF M 個購入で割引が適用されます。minimum_purchase_quantity と percent_off_percentage を指定する必要があります。
FREE_GIFT プレゼントの説明のみ。
FREE_GIFT_WITH_VALUE プレゼントの金額。
FREE_GIFT_WITH_ITEM_ID アイテム ID のプレゼント。
FREE_SHIPPING_STANDARD 標準の送料無料クーポンの値タイプ。
FREE_SHIPPING_OVERNIGHT 翌日配送の送料無料クーポンの値タイプ。
FREE_SHIPPING_TWO_DAY 2 日間送料無料クーポンの値タイプ。

GetPromotionRequest

GetPromotion メソッドに対するリクエスト メッセージ。

フィールド
name

string

必須。取得するプロモーションの名前。形式: accounts/{account}/promotions/{promotions}

InsertPromotionRequest

InsertPromotion メソッドに対するリクエスト メッセージ。

フィールド
parent

string

必須。プロモーションを挿入するアカウント。形式: accounts/{account}
promotion

Promotion

必須。挿入するプロモーション。
data_source

string

必須。プロモーション形式のデータソース: accounts/{account}/dataSources/{datasource}。

ListPromotionsRequest

ListPromotions メソッドに対するリクエスト メッセージ。

フィールド
parent

string

必須。処理済みのプロモーションを一覧表示するアカウント。形式: accounts/{account}
page_size

int32

出力専用。返されるプロモーションの最大数。サービスが返す値はこれよりも少ないことがあります。最大値は 1,000 です。1,000 を超える値は 1,000 に強制変換されます。指定されていない場合は、プロモーションの最大数が返されます。
page_token

string

出力専用。前回の ListPromotions 呼び出しから受け取ったページトークン。後続のページを取得するにはこれを指定します。

ページ分割を行う場合、ListPromotions に指定する他のすべてのパラメータは、ページトークンを提供した呼び出しと一致する必要があります。

ListPromotionsResponse

ListPromotions メソッドに対するレスポンス メッセージ。

フィールド
promotions[]

Promotion

指定したアカウントで処理されたプロモーション。
next_page_token

string

次のページを取得するために page_token として送信できるトークン。このフィールドを省略すると、後続のページはなくなります。

OfferType

プロモーションの特典タイプ。

列挙型
OFFER_TYPE_UNSPECIFIED 特典タイプが不明です。
NO_CODE コードなしの特典タイプです。
GENERIC_CODE コード付きの特典タイプです。offerType = GENERIC_CODE の場合は、プロモーションの汎用適用コードが必要です。

ProductApplicability

プロモーションを適用する商品または商品リスト。

列挙型
PRODUCT_APPLICABILITY_UNSPECIFIED プロモーションが適用される商品は不明です。
ALL_PRODUCTS すべての商品に適用されます。
SPECIFIC_PRODUCTS 1 つの商品または商品リストにのみ適用されます。

プロモーション

プロモーションを表します。詳しくは、次の記事をご覧ください。

データ検証チェックに合格するために必要なプロモーション入力属性は、主に以下で定義されています。

プロモーションの入力を挿入して更新した後、最終的なプロモーションを取得できるようになるまでに数分かかることがあります。

フィールド
name

string

ID。プロモーションの名前。形式: accounts/{account}/promotions/{promotion}
promotion_id

string

必須。プロモーションを一意に識別するためにユーザーが指定したプロモーション ID。プロモーションが不承認とならないように、最小要件を遵守してください。
content_language

string

必須。プロモーションを表す 2 文字の ISO 639-1 言語コード。

プロモーションは選択した言語でのみ利用できます。
target_country

string

必須。固有 ID の一部として使用される対象国。CLDR テリトリー コードで表されます。

プロモーションは一部の国でのみご利用いただけます。無料リスティングとショッピング広告、ローカル在庫広告、
redemption_channel[]

RedemptionChannel

必須。プロモーションの利用チャネル。チャネルが少なくとも 1 つ必要です。
data_source

string

出力専用。プロモーションのメイン データソース。
attributes

Attributes

省略可。プロモーション属性のリスト。
custom_attributes[]

CustomAttribute

省略可。カスタム（販売者指定）属性のリスト。また、データ仕様の任意の属性を一般形式（{ "name": "size type", "value": "regular" } など）で登録するためにも使用できます。これは、API で明示的に公開されていない属性を送信する場合に便利です。
promotion_status

PromotionStatus

出力専用。プロモーションのステータス、データ検証の問題、つまり非同期で計算されたプロモーションに関する情報。
version_number

int64

省略可。プロモーションの既存のバージョン（鮮度）を表します。複数の更新が同時に行われたときに正しい順序を保持するために使用できます。

設定すると、バージョン番号が既存のプロモーションの現在のバージョン番号よりも小さい場合、挿入できなくなります。再挿入（30 日後にプロモーションを更新するなど）は、現在の version_number で実行できます。

オペレーションが阻止されると、中止された例外がスローされます。

PromotionStatus

プロモーションのステータス。

フィールド
destination_statuses[]

DestinationStatus

出力専用。プロモーションの対象となる掲載先。
item_level_issues[]

ItemLevelIssue

出力専用。プロモーションに関連する問題のリスト。
creation_date

Timestamp

出力専用。プロモーションが作成された日付（ISO 8601 形式）: 日付、時刻、オフセット（例: 2020-01-02T09:00:00+01:00、2020-01-02T09:00:00Z）
last_update_date

Timestamp

出力専用。プロモーション ステータスが最後に更新された日付（ISO 8601 形式）: 日付、時刻、オフセット（例: 2020-01-02T09:00:00+01:00、2020-01-02T09:00:00Z）

DestinationStatus

指定されたデスティネーションのステータス。

フィールド
reporting_context

ReportingContextEnum

出力専用。プロモーションの掲載先の名前。
status

State

出力専用。指定されたデスティネーションのステータス。

状態

プロモーションの現在の状態。

列挙型
STATE_UNSPECIFIED プロモーションのステータスが不明です。
IN_REVIEW プロモーションは審査中です。
REJECTED プロモーションが不承認となった。
LIVE プロモーションは承認され、有効になっています。
STOPPED プロモーションは販売者によって停止されました。
EXPIRED プロモーションが無効になりました。
PENDING プロモーションは停止されておらず、すべての審査が承認されましたが、有効日が将来の日付です。

ItemLevelIssue

プロモーションに関連する問題。

フィールド
code

string

出力専用。問題のエラーコード。
severity

Severity

出力専用。この問題がプロモーションの提供に及ぼす影響
resolution

string

出力専用。販売者が問題を解決できるかどうか。
attribute

string

出力専用。属性の名前（問題の原因が 1 つの属性の場合）。
reporting_context

ReportingContextEnum

出力専用。問題が適用されるリンク先。
description

string

出力専用。問題の簡単な説明（英語）。
detail

string

出力専用。問題の詳細な説明（英語）。
documentation

string

出力専用。この問題の解決に役立つウェブページの URL。
applicable_countries[]

string

出力専用。問題がクーポンに適用される国コード（ISO 3166-1 alpha-2）のリスト。

重大度

問題の重大度。

列挙型
SEVERITY_UNSPECIFIED 指定されていません。
NOT_IMPACTED この問題は警告であり、プロモーションに直接影響を与えるものではありません。
DEMOTED プロモーションの順位が下がり、検索結果でのパフォーマンスが制限される可能性が高い
DISAPPROVED 問題によりプロモーションが不承認になる。

RedemptionChannel

プロモーションのチャネル。

列挙型
REDEMPTION_CHANNEL_UNSPECIFIED チャネルが指定されていないことを示します。
IN_STORE チャンネルがストアにあることを示します。これは、products に使用されている local チャネルと同じです。
ONLINE チャネルがオンラインであることを示します。

StoreApplicability

プロモーションを適用する店舗コードまたは店舗コードのリスト。ローカル在庫広告のプロモーションのみ。

列挙型
STORE_APPLICABILITY_UNSPECIFIED プロモーションが適用される店舗コードが不明。
ALL_STORES プロモーションはすべての店舗に適用されます。
SPECIFIC_STORES プロモーションは指定した店舗にのみ適用されます。