REST Resource: accounts.merchantReviews

ทรัพยากร: MerchantReview

รีวิวผู้ขาย ดูข้อมูลเพิ่มเติมได้ที่ข้อมูลเบื้องต้นเกี่ยวกับฟีดรีวิวจากผู้ขาย

การแสดง JSON 
{
  "name": string,
  "merchantReviewId": string,
  "attributes": {
    object (MerchantReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "merchantReviewStatus": {
    object (MerchantReviewStatus)
  }
}
ช่อง
name

string

ตัวระบุ ชื่อของรีวิวผู้ขาย รูปแบบ: "{merchantreview.name=accounts/{account}/merchantReviews/{merchantReview}}"
merchantReviewId

string

ต้องระบุ รหัสรีวิวของผู้ขายที่ผู้ใช้ระบุเพื่อระบุรีวิวของผู้ขายโดยไม่ซ้ำกัน
attributes

object (MerchantReviewAttributes)

ไม่บังคับ รายการแอตทริบิวต์รีวิวผู้ขาย
customAttributes[]

object (CustomAttribute)

ต้องระบุ รายการแอตทริบิวต์ที่กำหนดเอง (ผู้ขายระบุ) นอกจากนี้ยังใช้ส่งแอตทริบิวต์ของข้อกำหนดในการจัดทำข้อมูลในรูปแบบทั่วไป (เช่น { "name": "size type", "value": "regular" }) ได้ด้วย ซึ่งมีประโยชน์สำหรับการส่งแอตทริบิวต์ที่ API ไม่ได้แสดงอย่างชัดเจน เช่น แอตทริบิวต์เวอร์ชันทดลอง จำนวนอักขระสูงสุดที่อนุญาตสำหรับแอตทริบิวต์ที่กำหนดเองแต่ละรายการคือ 10240 (แสดงผลรวมของอักขระสำหรับชื่อและค่า) คุณตั้งค่าแอตทริบิวต์ที่กำหนดเองได้สูงสุด 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 วันที่ผ่านมาอ้างอิงถึงผู้ขายรายเดียวกัน คำขอดังกล่าวต้องมีรหัสเดียวกัน
merchantDisplayName

string

ไม่บังคับ ชื่อที่แสดงสำหรับผู้ขายซึ่งมนุษย์อ่านได้
minRating

string (int64 format)

ไม่บังคับ จำนวนขั้นต่ำที่เป็นไปได้สำหรับคะแนน ค่านี้ควรเป็นคะแนนที่แย่ที่สุดที่เป็นไปได้และไม่ควรเป็นค่าสำหรับไม่มีคะแนน
maxRating

string (int64 format)

ไม่บังคับ จำนวนสูงสุดที่เป็นไปได้สำหรับคะแนน ค่าของคะแนนสูงสุดต้องมากกว่าค่าของคะแนนต่ำสุด
rating

number

ไม่บังคับ คะแนนโดยรวมของผู้รีวิวผู้ขาย
title

string

ไม่บังคับ ชื่อรีวิว
content

string

ต้องระบุ ข้อความนี้ควรเป็นข้อความรูปแบบอิสระที่ผู้ใช้ระบุไว้และไม่ควรถูกตัด หากมีการตอบคำถามหลายข้อ ก็ควรใส่คำตอบทั้งหมดพร้อมบริบทขั้นต่ำเพื่อให้คำตอบมีความเกี่ยวข้อง คุณไม่ควรระบุบริบทหากคำถามไม่ได้รับคำตอบ
reviewerId

string

ไม่บังคับ ตัวระบุที่ไม่ซ้ำกันแบบถาวรของผู้เขียนรีวิวในระบบของผู้จัดพิมพ์
reviewerUsername

string

ไม่บังคับ ชื่อที่แสดงของผู้เขียนรีวิว
isAnonymous

boolean

ไม่บังคับ ตั้งค่าเป็น "จริง" หากผู้รีวิวควรไม่ระบุตัวตน
collectionMethod

enum (CollectionMethod)

ไม่บังคับ วิธีการรวบรวมรีวิว
reviewTime

string (Timestamp format)

ต้องระบุ การประทับเวลาที่ระบุเวลาที่เขียนรีวิว
reviewLanguage

string

ต้องระบุ ภาษาของรีวิวที่ระบุโดยรหัสภาษา BCP-47
reviewCountry

string

ไม่บังคับ ประเทศที่ผู้รีวิวทำการสั่งซื้อซึ่งกำหนดโดยรหัสประเทศ ISO 3166-1 Alpha-2

CollectionMethod

วิธีการรวบรวมรีวิว

Enum
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 ของหน้าเว็บเพื่อช่วยแก้ไขปัญหานี้

ความรุนแรง

ปัญหาส่งผลต่อการแสดงรีวิวผู้ขายอย่างไร

Enum
SEVERITY_UNSPECIFIED ไม่ได้ระบุ
NOT_IMPACTED ปัญหานี้แสดงถึงคำเตือนและไม่มีผลโดยตรงต่อรีวิวผู้ขาย
DISAPPROVED ปัญหาที่ไม่ได้รับอนุมัติรีวิวผู้ขาย

เมธอด

delete

 ลบรีวิวผู้ขาย

get

 รับรีวิวผู้ขาย

insert

 แทรกรีวิวสำหรับบัญชี Merchant Center

list

 แสดงรีวิวผู้ขาย