REST Resource: accounts.merchantReviews

リソース: MerchantReview

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

JSON 表現 
{
  "name": string,
  "merchantReviewId": string,
  "attributes": {
    object (MerchantReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "merchantReviewStatus": {
    object (MerchantReviewStatus)
  }
}
フィールド
name

string

ID。販売者レビューの名前。形式: "{merchantreview.name=accounts/{account}/merchantReviews/{merchantReview}}"
merchantReviewId

string

必須。販売者レビューを一意に識別するために、ユーザーが指定した販売者レビュー ID。
attributes

object (MerchantReviewAttributes)

省略可。販売者のレビュー属性のリスト。
customAttributes[]

object (CustomAttribute)

必須。カスタム（販売者指定）属性のリスト。また、データ仕様の任意の属性を一般形式（{ "name": "size type", "value": "regular" } など）で登録するためにも使用できます。試験運用版属性など、API で明示的に公開されていない属性を登録する場合に便利です。各カスタム属性の最大許容文字数は 10,240 文字です（名前と値の文字数の合計）。1 つの商品に設定できるカスタム属性は最大 2, 500 個で、合計サイズは 102.4 KB です。カスタム属性名のアンダースコアは、挿入時にスペースに置き換えられます。
dataSource

string

出力専用。販売者レビューのメインのデータソース。
merchantReviewStatus

object (MerchantReviewStatus)

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

MerchantReviewAttributes

属性。

JSON 表現 
{
  "merchantId": string,
  "merchantDisplayName": string,
  "merchantLink": string,
  "merchantRatingLink": string,
  "minRating": string,
  "maxRating": string,
  "rating": number,
  "title": string,
  "content": string,
  "reviewerId": string,
  "reviewerUsername": string,
  "isAnonymous": boolean,
  "collectionMethod": enum (CollectionMethod),
  "reviewTime": string,
  "reviewLanguage": string,
  "reviewCountry": string
}
フィールド
merchantId

string

必須。すべてのリクエストで一意で安定している必要があります。つまり、今日のリクエストと 90 日前のリクエストが同じ販売者を指す場合は、同じ ID を使用する必要があります。
merchantDisplayName

string

省略可。販売者の表示名（人が読める形式）。
minRating

string (int64 format)

省略可。評価に使用できる最小値。これは、可能な限り低い評価である必要があります。評価なしの値にすべきではありません。
maxRating

string (int64 format)

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

number

省略可。販売者に対するクチコミ投稿者の総合的な評価。
title

string

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

string

必須。ユーザーが入力した自由形式のテキストを入力し、省略しないでください。異なる質問に対する回答が複数ある場合は、すべての回答を含める必要があります。回答が理解できるように、最小限のコンテキストも含める必要があります。質問に回答が得られなかった場合は、コンテキストを提供しない。
reviewerId

string

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

string

省略可。レビュー投稿者の表示名。
isAnonymous

boolean

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

enum (CollectionMethod)

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

string (Timestamp format)

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

string

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

string

省略可。レビュー担当者が注文した国（ISO 3166-1 alpha-2 国コードで定義）。

CollectionMethod

クチコミの収集に使用された方法。

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

MerchantReviewStatus

販売者レビューのステータス、データ検証の問題、つまり非同期で計算された販売者のレビューに関する情報です。

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

object (MerchantReviewDestinationStatus)

出力専用。販売者レビューの掲載先。
itemLevelIssues[]

object (MerchantReviewItemLevelIssue)

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

string (Timestamp format)

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

string (Timestamp format)

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

MerchantReviewDestinationStatus

販売者のレビュー ステータスのリンク先ステータス。

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

enum (ReportingContextEnum)

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

MerchantReviewItemLevelIssue

販売者の審査ステータスの 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

 Merchant Center アカウントのレビューを挿入します。

list

 販売者のレビューを一覧表示します。