Package google.shopping.css.v1

string

ラベルのリソース名。形式: accounts/{account}

string

出力専用。変更不可。CSS/MC アカウントの氏名。

int64

CSS 親アカウントによって CSS/MC アカウントに割り当てられた、手動で作成されたラベル ID。

int64

CSS Center によって MC アカウントに割り当てられた、自動的に作成されたラベル ID。

AccountType

出力専用。このアカウントのタイプ。

string

CSS/MC アカウントの短い表示名。

string

出力専用。変更不可。CSS/MC アカウントのホームページ。

string

CSS/MC アカウントの親リソース。CSS ドメインの場合は CSS グループ、MC アカウントの場合は CSS ドメイン。ユーザーが親アカウントにアクセスできる場合にのみ返されます。注: MC サブアカウントの場合、階層を効果的にフラット化しているため、これは MCA アカウントの親リソースである CSS ドメインでもあります。

string

ID。ラベルのリソース名。形式: accounts/{account}/labels/{label}

int64

出力専用。ラベルの ID。

int64

出力専用。このラベルが属するアカウントの ID。

LabelType

出力専用。このラベルのタイプ。

string

このラベルの表示名。

string

このラベルの説明。

Price

CSS 商品の低価格。

Price

CSS 商品の最高価格。

Price

CSS 商品のヘッドライン価格。

Price

CSS 商品のヘッドライン価格。

string

商品アイテムの画像の追加 URL。

string

アイテムのカテゴリ（商品データ仕様に準拠した形式）。

string

商品アイテムのカット。アパレル アイテムの組み合わせサイズタイプを表すために使用できます。指定できるサイズタイプは 2 つまでです（サイズの種類を参照）。

ProductDetail

技術仕様または追加の商品詳細。

ProductWeight

指定された単位での商品の重量。値は 0 より大きく 2,000 以下の範囲で指定する必要があります。

ProductDimension

指定された単位での商品の長さ。値は 0 より大きく 3,000 以下の範囲で指定する必要があります。

ProductDimension

指定された単位での商品の幅。値は 0 より大きく 3,000 以下の範囲で指定する必要があります。

ProductDimension

指定された単位での商品の高さ。値は 0 より大きく 3,000 以下の範囲で指定する必要があります。

string

商品の最も関連性の高いハイライトを説明する箇条書き。

Certification

特定の製品について CSS が主張する証明書のリスト。

Timestamp

商品アイテムの有効期限（日付）。挿入時に指定されます。ISO 8601 形式で指定します。実際の有効期限は productstatuses で googleExpirationDate として公開されます。expirationDate が未来の日付である場合は、有効期限が早まる可能性があります。注: アイテムが実際に削除されるまでには、有効期限から 2 日以上かかることがあります。

string

このターゲット向けに含める掲載先のリストです（Merchant Center でオンになっているチェックボックスに対応します）。デフォルトの掲載先は、excludedDestinations で指定しない限り、常に含まれます。

string

このターゲットで除外する掲載先のリスト（Merchant Center でオフになっているチェックボックスに対応します）。

HeadlineOfferInstallment

商品の分割払いの回数と金額。

HeadlineOfferSubscriptionCost

関連付けられたサブスクリプション契約があるアイテムの期間（月または年）の数と、期間あたりの支払い額。

string

CSS の商品詳細ページに直接リンクする URL。

string

CSS の商品詳細ページのモバイル デバイス向けバージョンの URL。

string

商品が商品広告のコンテキスト内で表示される場合に、広告主がアイテム URL をオーバーライドできるようにします。

int64

CSS 商品の数。

string

ヘッドライン オファーの条件。

string

ヘッドライン オファーへのリンク。

string

ヘッドライン オファーへのモバイルリンク。

string

商品アイテムの商品名。

string

商品アイテムの画像の URL。

string

項目の説明。

string

商品関連属性。[14-36] 商品のブランド。

string

商品アイテムの商品の製造番号（MPN）。

string

商品アイテムの国際取引商品番号（GTIN）。

string

商品の Google カテゴリ（Google の商品分類を参照）。商品をクエリする場合、このフィールドにはユーザーが指定した値が含まれます。現在、API を介して自動割り当てされた Google 商品カテゴリを取得する方法はありません。

bool

商品アイテムが成人向けの場合は true に設定します。

int64

販売者が定めるマルチパックに含まれる同一商品の数量。

bool

アイテムが販売者が定める一括販売かどうか。一括販売商品とは、販売者が単一の価格で販売する、さまざまな商品を独自に組み合わせたものです。

string

商品アイテムの対象となる年齢層。

string

商品アイテムの色。

string

商品アイテムの対象層の性別。

string

商品アイテムの素材。

string

商品アイテムの柄（水玉模様など）。

string

商品のサイズ。指定できる値は 1 つのみです。サイズ違いのバリエーションの場合、サイズごとに別々の商品を挿入し、同じ itemGroupId 値を指定します（[https://support.google.com/merchants/answer/6324492](サイズの定義) を参照）。

string

サイズが指定されているシステム。ファッション関連の商品アイテムに推奨されます。

string

同一商品でバリエーションがある場合の共通 ID。

string

このアイテムの公開は一時的に停止されます。

string

ショッピング キャンペーンの商品アイテムのカスタム グループを表すカスタムラベル 0。

string

ショッピング キャンペーンの商品アイテムのカスタム グループを表すカスタムラベル 1。

string

ショッピング キャンペーンの商品アイテムのカスタム グループを表すカスタムラベル 2。

string

ショッピング キャンペーンの商品アイテムのカスタム グループを表すカスタムラベル 3。

string

ショッピング キャンペーンの商品アイテムのカスタム グループを表すカスタムラベル 4。

int64

商品のレビュー数。rating が指定されている場合は必須です。このフィールドは今後の機能のためのものであり、まだ使用されていません。

int64

商品の最小評価スコア。rating が指定されている場合は必須です。このフィールドは今後の機能のためのものであり、まだ使用されていません。

int64

商品の最大評価スコア。rating が指定されている場合は必須です。このフィールドは今後の機能のためのものであり、まだ使用されていません。

double

商品の平均評価スコア。値は [min_rating, max_rating] の範囲内にする必要があります（最小値と最大値を範囲に含む）。商品ページに表示される場合、この評価は小数点以下 1 桁の [1, 5] のスケールに正規化されます。指定する場合は、review_count、min_rating、max_rating も必須です。このフィールドは今後の機能のためのものであり、まだ使用されていません。

string

認証の名称現時点では、最も一般的な値は「EPREL」です。これは、EU の European Registry for Energy Labeling（EPREL）データベースのエネルギー効率認証を表します。

string

認証を発行する権限を有する機関または認証機関。現時点では、EU のエネルギー ラベルの「EC」または「European_Commission」が最も一般的な値です。

string

認証のコード。たとえば、リンクが https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456 の EPREL 認証の場合、コードは 123456 です。このコードは欧州エネルギー ラベルに必要です。

string

必須。親アカウント。形式: accounts/{account}

AccountLabel

必須。作成するラベル。

string

CSS 商品の名前。形式: "accounts/{account}/cssProducts/{css_product}"

string

出力専用。商品の一意の未加工の識別子。

string

出力専用。商品の 2 文字の ISO 639-1 言語コード。

string

出力専用。商品のフィードラベル。

Attributes

出力専用。商品属性のリスト。

CustomAttribute

出力専用。カスタム（CSS 提供）属性のリスト。また、フィード仕様の任意の属性を汎用形式（{ "name": "size type", "value": "regular" } など）で送信するためにも使用できます。これは、「Google で購入」で使用される追加属性など、API で明示的に公開されていない属性を送信する場合に便利です。

CssProductStatus

出力専用。商品のステータス、データ検証の問題（非同期で計算された商品に関する情報）。

string

ID。CSS 商品入力の名前。形式: accounts/{account}/cssProductInputs/{css_product_input}。最後のセクション css_product_input は、contentLanguage~feedLabel~offerId の 3 つの部分で構成されます。例: accounts/123/cssProductInputs/de~DE~rawProvidedId123

string

出力専用。処理された CSS 商品の名前。形式: accounts/{account}/cssProducts/{css_product} "

string

必須。CSS 商品の一意の識別子。これは、CSS 商品の入力と処理済みの CSS 商品でも同様です。英数字、アンダースコア、ダッシュを含む ID のみ使用できます。詳しくは、商品フィード仕様をご覧ください。

string

必須。CSS 商品の 2 文字の ISO 639-1 言語コード。

string

必須。CSS 商品のフィード ラベル。フィードラベルは「対象国」と同義であるため、常に有効な地域コードである必要があります。例: ドイツの場合は「DE」、フランスの場合は「FR」。

Timestamp

非推奨。代わりに expiration_date を使用してください。CSS 商品の既存のバージョン（鮮度）を表します。複数の更新が同時に行われた場合に、正しい順序を維持するために使用できます。

このフィールドに将来の時刻を設定することはできません。

設定されている場合、アイテムの新しいバージョンがすでにシステムに存在する場合（つまり、既存の CSS 商品の最終更新日時が、更新で設定された鮮度時間よりも新しい場合）、更新は行われません。更新が行われると、最終更新時刻がこの鮮度時刻に設定されます。

設定されていない場合、更新は阻止されず、最終更新時刻はデフォルトでこのリクエストが CSS API によって受信された時刻になります。

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

Attributes

CSS 商品属性のリスト。

CustomAttribute

カスタム（CSS 提供）属性のリスト。また、フィード仕様の属性を一般的な形式（{ "name": "size type", "value": "regular" } など）で送信する場合にも使用できます。これは、「Google で購入」で使用される追加属性など、API で明示的に公開されていない属性を送信する場合に便利です。

DestinationStatus

商品アイテムの宛先。

ItemLevelIssue

商品に関連付けられているすべての問題のリスト。

Timestamp

アイテムが作成された日付（ISO 8601 形式）。

Timestamp

アイテムが最後に更新された日付（ISO 8601 形式）。

Timestamp

アイテムの有効期限が切れる日付（ISO 8601 形式）。

string

宛先の名前

string

CSS 商品が承認されている国コード（ISO 3166-1 alpha-2）のリスト。

string

CSS 商品の承認が保留中の国コード（ISO 3166-1 alpha-2）のリスト。

string

CSS 商品が不承認の国コード（ISO 3166-1 alpha-2）のリスト。

string

問題のエラーコード。

string

この問題による CSS 商品のサービスへの影響。

string

販売者側で問題が解決可能かどうか。

string

属性名（問題の原因が単一属性の場合）。

string

問題の適用先。

string

問題の簡単な説明（英語）。

string

問題の詳しい説明（英語）。

string

この問題の解決に役立つウェブページの URL。

string

問題が CSS 商品に適用される国コード（ISO 3166-1 alpha-2）のリスト。

string

必須。削除するラベルの名前。形式: accounts/{account}/labels/{label}

string

必須。削除する CSS 商品入力リソースの名前。形式: accounts/{account}/cssProductInputs/{css_product_input}。最後のセクション css_product_input は、contentLanguage~feedLabel~offerId の 3 つの部分で構成されます。例: accounts/123/cssProductInputs/de~DE~rawProvidedId123

int64

Content API 補助フィード ID。アクションがメインフィードに適用される場合、このフィールドは設定できません。このフィールドが設定されている場合、商品アクションはメインの Content API フィードではなく、補助フィードに適用されます。

string

必須。管理対象の CSS/MC アカウントの名前。形式: accounts/{account}

string

省略可。MC アカウント情報を取得する場合にのみ必要です。MC アカウントの親リソースである CSS ドメイン。形式: accounts/{account}

string

必須。取得する CSS 商品の名前。形式: accounts/{account}/cssProducts/{css_product}

int64

購入代金の分割回数。

Price

購入者が毎月支払う金額。

Price

購入者が支払う必要のある頭金の金額。

SubscriptionPeriod

定期購入期間のタイプ。サポートされている値は、month と year です。

int64

購入者が支払う定期購入の期間。

Price

購入者が定期購入期間ごとに支払う金額。

string

必須。この CSS 商品が挿入されるアカウント。形式: accounts/{account}

CssProductInput

必須。挿入する CSS 商品入力。

int64

省略可。非推奨。CSS 商品ではフィード ID は必須ではありません。メインフィードまたは補助フィードの ID。CSS 商品がすでに存在し、指定されたフィード ID が異なる場合、CSS 商品は新しいフィードに移動されます。注: 現時点では、フィードはオンザフライで作成されるため、CSS がフィード ID を提供する必要はありません。CSS 商品の補助フィードはまだサポートされていません。

string

必須。親アカウント。形式: accounts/{account}

int32

返すラベルの最大数。サービスが返す値はこれよりも少ないことがあります。指定されていない場合、最大で 50 個のラベルが返されます。最大値は 1,000 です。1,000 を超える値は 1,000 に強制変換されます。

string

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

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

AccountLabel

指定したアカウントのラベル。

string

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

string

必須。親アカウント。CSS グループまたはドメインである必要があります。形式: accounts/{account}

int32

省略可。返されるアカウントの最大数。サービスが返す値はこれよりも少ないことがあります。指定されていない場合は、最大で 50 個のアカウントが返されます。最大値は 100 です。100 を超える値は 100 に強制変換されます。

string

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

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

int64

設定すると、指定されたラベル ID を持つ MC アカウントのみが返されます。

string

設定すると、指定された名前（大文字と小文字を区別）の MC アカウントのみが返されます。

Account

指定された CSS 親アカウントに対して返された CSS アカウントまたは MC アカウント。

string

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

string

必須。処理済みの CSS 商品を一覧表示するアカウント/ドメイン。形式: accounts/{account}

int32

返す CSS 商品の最大数。サービスが返す値はこれよりも少ないことがあります。最大値は 1,000 です。1,000 を超える値は 1,000 に強制変換されます。指定されていない場合、CSS 商品の最大数が返されます。

string

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

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

CssProduct

指定されたアカウントの処理済み CSS 商品。これらは、ルールと補助フィードを適用した後の処理済みの CSS 商品です。

string

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

string

必須。メソッドの割り当てとリソースのコレクションを所有する CSS アカウント。ほとんどの場合、これは CSS ドメインです。形式: accounts/{account}

int32

省略可。レスポンスで返される割り当ての最大数。ページングに使用されます。デフォルトは 500 です。1,000 を超える値は 1,000 に強制変換されます。

string

省略可。後続のページを取得するためのトークン（指定されている場合）。他のすべてのパラメータは、ページトークンを提供した元の呼び出しと一致している必要があります。

QuotaGroup

メソッド、現在の割り当て使用量、各グループの上限。割り当ては、グループ内のすべてのメソッド間で共有されます。グループは quota_usage に基づいて降順で並べ替えられます。

string

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

string

出力専用。メソッドの名前（例: cssproductsservice.listcssproducts）。

string

出力専用。メソッドが属する API バージョン。

string

出力専用。メソッドが属するサブ API。CSS API では、これは常に css です。

string

出力専用。メソッドのパス（v1/cssproductsservice.listcssproducts など）。

string

一連の商品詳細をグループ化するために使用されるセクション ヘッダー。

string

商品の詳細の名前。

string

商品の詳細の値。

double

必須。数値で表されるディメンション値。値の精度は小数点以下 4 桁までです。

string

必須。ディメンションの単位。有効な値は次のとおりです。* 「in」* 「cm」

double

必須。重みを数値で表します。重みの精度は小数点以下 4 桁までです。

string

必須。重量の単位。有効な値は次のとおりです。* 「g」* 「kg」* 「oz」* 「lb」

string

ID。割り当てグループのリソース名。形式: accounts/{account}/quotas/{group} 例: accounts/12345678/quotas/css-products-insert 注: {group} 部分は特定のパターンに従うとは限りません。

int64

出力専用。現在の割り当て使用量。つまり、特定の日付にグループ内のメソッドに対してすでに行われた呼び出しの数。1 日の割り当て上限は、UTC の正午 12:00 にリセットされます。

int64

出力専用。グループで 1 日に許可される呼び出しの最大数。

int64

出力専用。グループに対して 1 分あたりに許可される呼び出しの最大数。

MethodDetails

出力専用。メソッド グループの割り当てが適用されるすべてのメソッドのリスト。

AccountLabel

必須。更新されたラベル。すべてのフィールドを指定する必要があります。

string

必須。ラベルのリソース名。形式: accounts/{account}

int64

既存のアカウント ラベル ID を上書きするラベル ID のリスト。リストが空の場合、現在割り当てられているすべてのラベル ID が削除されます。

string

省略可。MC アカウントのラベルを更新する場合にのみ必要です。MC アカウントの親リソースである CSS ドメイン。形式: accounts/{account}

CssProductInput

必須。更新する CSS 商品入力リソース。送信された情報は、処理済みの CSS 商品にも適用されます。

FieldMask

更新する CSS 商品属性のリスト。

更新マスクが省略されている場合は、値が設定されている（空でない値を持つ）すべてのフィールドに相当する暗黙的なフィールド マスクとして扱われます。

本文で値が指定されていない更新マスクで指定された属性は、CSS 商品から削除されます。

更新マスクは、属性とカスタム属性の最上位フィールドに対してのみ指定できます。

カスタム属性の更新マスクを指定するには、custom_attribute. 接頭辞を追加する必要があります。

CSS 商品の完全な置き換えに特別な「*」値を指定することはできません。