REST Resource: accounts.products

リソース: Product

ルールと補助データソースを適用した後、複数の product inputs から構築された処理済みプロダクト。この処理済み商品は、Merchant Center アカウント、ショッピング広告、Google のその他のサービスに表示される商品と一致しています。各商品は、メインの商品データソースの入力と複数の補助データソースの入力から作成されます。商品入力を挿入、更新、削除した後、更新された処理済み商品を取得できるようになるまでに数分かかることがあります。

処理された商品とそのサブメッセージのすべてのフィールドは、商品データ仕様の対応する属性の名前と一致します（一部の例外を除く）。

JSON 表現 
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
フィールド
name

string

商品の名前。形式: "{product.name=accounts/{account}/products/{product}}"。最後のセクション product は、channel~contentLanguage~feedLabel~offerId の 4 つの部分で構成されます。商品名の例は「accounts/123/products/online~en~US~sku123」です。
channel

enum (ChannelEnum)

出力専用。商品のチャネル。
offerId

string

出力専用。商品の一意の識別子。これは、製品の入力と加工後の製品で同じです。送信時に、先頭と末尾の空白文字が削除され、複数の空白文字は 1 つの空白文字に置き換えられます。詳しくは、商品データ仕様をご覧ください。
contentLanguage

string

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

string

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

string

出力専用。商品のメインの参照元データソース。
attributes

object (Attributes)

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

object (CustomAttribute)

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

object (ProductStatus)

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

string (int64 format)

出力専用。商品の既存のバージョン（新しさ）を表します。複数の更新が同時に行われたときに正しい順序を維持するために使用できます。

設定すると、バージョン番号が既存の商品の現在のバージョン番号より小さい場合、挿入がブロックされます。再挿入（30 日後の商品の更新など）は、現在の versionNumber で実行できます。

プライマリ データソースへの挿入でのみサポートされます。

オペレーションが防止された場合、中断された例外がスローされます。

ProductStatus

商品のステータス、データ検証の問題など、非同期で計算された商品に関する情報。

JSON 表現 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
フィールド
destinationStatuses[]

object (DestinationStatus)

商品アイテムの宛先。
itemLevelIssues[]

object (ItemLevelIssue)

商品に関連するすべての問題のリスト。
creationDate

string (Timestamp format)

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

string (Timestamp format)

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

string (Timestamp format)

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

DestinationStatus

商品ステータスの宛先ステータス。

JSON 表現 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
フィールド
reportingContext

enum (ReportingContextEnum)

レポート コンテキストの名前。
approvedCountries[]

string

クーポンが承認されている国コード（ISO 3166-1 alpha-2）のリスト。
pendingCountries[]

string

クーポンの承認が保留中の国コード（ISO 3166-1 alpha-2）のリスト。
disapprovedCountries[]

string

クーポンが不承認の国コード（ISO 3166-1 alpha-2）のリスト。

ItemLevelIssue

商品ステータスの ItemLevelIssue。

JSON 表現 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
フィールド
code

string

問題のエラーコード。
severity

enum (Severity)

この問題によるサービスへの影響。
resolution

string

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

string

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

enum (ReportingContextEnum)

問題が適用されるレポート コンテキスト。
description

string

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

string

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

string

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

string

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

重大度

この問題が商品の掲載にどのように影響するか。

列挙型
SEVERITY_UNSPECIFIED 指定されていません。
NOT_IMPACTED この問題は警告であり、プロダクトには直接影響しません。
DEMOTED 商品が降格され、検索結果でのパフォーマンスが制限されている可能性が高い
DISAPPROVED 問題により商品が不承認となる。

メソッド

get

 Merchant Center アカウントから処理済み商品を取得します。

list

 Merchant Center アカウントで処理された商品を一覧表示します。