REST Resource: accounts.productReviews

リソース: ProductReview

商品のレビュー。詳しくは、商品レビュー フィードの概要をご覧ください。

JSON 表現 
{
  "name": string,
  "productReviewId": string,
  "attributes": {
    object (ProductReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "productReviewStatus": {
    object (ProductReviewStatus)
  }
}
フィールド
name

string

ID。商品レビューの名前です。形式: "{productreview.name=accounts/{account}/productReviews/{productReview}}"
productReviewId

string

必須。パブリッシャーのシステムにおける商品レビューの永続的な固有 ID。
attributes

object (ProductReviewAttributes)

省略可。商品レビューの属性のリスト。
customAttributes[]

object (CustomAttribute)

省略可。カスタム（販売者指定）属性のリスト。
dataSource

string

出力専用。商品レビューのメイン データソース。
productReviewStatus

object (ProductReviewStatus)

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

ProductReviewAttributes

属性。

JSON 表現 
{
  "reviewTime": string,
  "pros": [
    string
  ],
  "cons": [
    string
  ],
  "reviewLink": {
    object (ReviewLink)
  },
  "reviewerImageLinks": [
    string
  ],
  "productNames": [
    string
  ],
  "productLinks": [
    string
  ],
  "asins": [
    string
  ],
  "gtins": [
    string
  ],
  "mpns": [
    string
  ],
  "skus": [
    string
  ],
  "brands": [
    string
  ],
  "collectionMethod": enum (CollectionMethod),
  "transactionId": string,
  "aggregatorName": string,
  "subclientName": string,
  "publisherName": string,
  "publisherFavicon": string,
  "reviewerId": string,
  "reviewerIsAnonymous": boolean,
  "reviewerUsername": string,
  "reviewLanguage": string,
  "reviewCountry": string,
  "title": string,
  "content": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "isSpam": boolean
}
フィールド
reviewTime

string (Timestamp format)

必須。クチコミが投稿されたときのタイムスタンプです。
pros[]

string

省略可。レビュアーの意見に基づく利点が含まれます。「pro:」などのボイラープレート テキストは、レビュアーが書いたもの以外は省略します。
cons[]

string

省略可。レビュー投稿者の意見に基づくデメリットが含まれます。レビュアーが書いたもの以外は、「con:」のような定型文は使用しないでください。
productNames[]

string

省略可。商品のわかりやすい名前。
asins[]

string

省略可。商品に関連付けられている ASIN（Amazon Standard Identification Number）が含まれます。
gtins[]

string

省略可。商品に関連付けられている GTIN（国際取引商品番号）が含まれます。GTIN のサブタイプ（UPC、EAN、ISBN、JAN など）がサポートされています。
mpns[]

string

省略可。商品に関連付けられた MPN（製造者が定める製品番号）が含まれます。
skus[]

string

省略可。商品に関連付けられた SKU（最小管理単位）が含まれています。多くの場合、商品フィードの商品 ID と一致します。
brands[]

string

省略可。商品に関連付けられているブランド名が含まれます。
collectionMethod

enum (CollectionMethod)

省略可。レビューの収集方法。
transactionId

string

省略可。パブリッシャーのシステムでレビューに関連付けられた取引の永続的な一意の識別子。この ID は、複数のクチコミが同じ取引に関連付けられていることを示すために使用できます。
aggregatorName

string

省略可。商品レビューのアグリゲータの名前。

ニュース メディアは、レビュー アグリゲータを使用してレビューを管理し、フィードを提供できます。この要素は、アグリゲータの使用を示しており、アグリゲータに関する情報が含まれています。
subclientName

string

省略可。商品レビューのサブクライアントの名前。

サブクライアントは、商品レビューのソースの識別子です。ファイル データソースのパスで指定されたディレクトリと同じである必要があります。
publisherName

string

省略可。商品レビューの公開元の名前。

パブリッシャーに関する情報（販売店、メーカー、レビュー サービス会社、商品レビューを公開する事業体など）。
publisherFavicon

string

省略可。パブリッシャーの会社のファビコンへのリンク。画像のサイズはファビコンのサイズ（16x16 ピクセル）にする必要があります。画像形式は GIF、JPG、PNG のいずれかである必要があります。
reviewerId

string

省略可。商品レビューの投稿者。

パブリッシャーのシステムにおけるレビューの作成者を示す永続的な一意の識別子。
reviewerIsAnonymous

boolean

省略可。クチコミ投稿者を匿名のままにする場合は true に設定します。
reviewerUsername

string

省略可。商品レビューの投稿者の名前。
reviewLanguage

string

省略可。BCP-47 言語コードで定義されたレビューの言語。
reviewCountry

string

省略可。ISO 3166-1 Alpha-2 Country Code で定義されたレビューの国。
title

string

省略可。レビューのタイトル。
content

string

必須。レビューの内容。
minRating

string (int64 format)

省略可。レビューに関連付けられている評価が含まれます。評価に使用できる最小値。これは、可能な限り低い評価である必要があります。評価なしの値にすべきではありません。
maxRating

string (int64 format)

省略可。評価に使用できる最大数。最大評価の値は、最小属性の値よりも大きくする必要があります。
rating

number

省略可。商品に対するレビュー投稿者の総合的な評価。
isSpam

boolean

省略可。レビューがパブリッシャーのシステムでスパムとしてマークされているかどうかを示します。

タイプ

レビュー URI のタイプ。

列挙型
TYPE_UNSPECIFIED 未指定
SINGLETON レビュー ページには、この 1 件のレビューのみが表示されます。
GROUP レビューページには、このレビューを含むレビューのグループが表示されます。

CollectionMethod

レビューの収集方法。

列挙型
COLLECTION_METHOD_UNSPECIFIED 収集方法が指定されていません。
UNSOLICITED ユーザーがレビューを送信したときに、特定の要請に応答していなかった。
POST_FULFILLMENT ユーザーの注文の処理後に、ユーザーがリクエストに応じてレビューを送信した。

ProductReviewStatus

商品レビューのステータス。

JSON 表現 
{
  "destinationStatuses": [
    {
      object (ProductReviewDestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ProductReviewItemLevelIssue)
    }
  ],
  "createTime": string,
  "lastUpdateTime": string
}
フィールド
destinationStatuses[]

object (ProductReviewDestinationStatus)

出力専用。商品レビューの宛先。
itemLevelIssues[]

object (ProductReviewItemLevelIssue)

出力専用。商品レビューに関連するすべての問題のリスト。
createTime

string (Timestamp format)

出力専用。アイテムが作成された日付（ISO 8601 形式）。
lastUpdateTime

string (Timestamp format)

出力専用。商品アイテムの最終更新日（ISO 8601 形式）。

ProductReviewDestinationStatus

商品レビューのステータスの宛先ステータス。

JSON 表現 
{
  "reportingContext": enum (ReportingContextEnum)
}
フィールド
reportingContext

enum (ReportingContextEnum)

出力専用。レポート コンテキストの名前。

ProductReviewItemLevelIssue

商品レビューのステータスの ItemLevelIssue。

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

string

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

enum (Severity)

出力専用。この問題による商品レビューの掲載への影響。
resolution

string

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

string

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

enum (ReportingContextEnum)

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

string

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

string

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

string

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

重大度

この問題が商品レビューの配信にどのように影響するか。

列挙型
SEVERITY_UNSPECIFIED 指定されていません。
NOT_IMPACTED この問題は警告であり、商品レビューに直接影響することはありません。
DISAPPROVED 問題により商品レビューが不承認となる。

メソッド

delete

 商品レビューを削除します。

get

 商品レビューを取得します。

insert

 商品レビューを挿入します。

list

 商品レビューを一覧表示します。