REST Resource: accounts.productReviews

ทรัพยากร: ProductReview

รีวิวสำหรับผลิตภัณฑ์ ดูข้อมูลเพิ่มเติมได้ที่ข้อมูลเบื้องต้นเกี่ยวกับฟีดรีวิวผลิตภัณฑ์

การแสดง JSON
{
  "name": string,
  "productReviewId": string,
  "attributes": {
    object (ProductReviewAttributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "dataSource": string,
  "productReviewStatus": {
    object (ProductReviewStatus)
  }
}
ช่อง
name

string

ตัวระบุ ชื่อรีวิวผลิตภัณฑ์ รูปแบบ: "{productreview.name=accounts/{account}/productReviews/{productReview}}"

productReviewId

string

ต้องระบุ ตัวระบุที่ไม่ซ้ำกันแบบถาวรของรีวิวผลิตภัณฑ์ในระบบของผู้เผยแพร่โฆษณา

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

ไม่บังคับ ระบุข้อเสียตามความคิดเห็นของผู้รีวิว หลีกเลี่ยงการใช้ข้อความสำเร็จรูป เช่น "ข้อเสีย:" เว้นแต่ผู้รีวิวจะเป็นผู้เขียน

productNames[]

string

ไม่บังคับ ชื่อผลิตภัณฑ์ที่สื่อความหมาย

asins[]

string

ไม่บังคับ มี ASIN (หมายเลขประจำตัวมาตรฐานของ Amazon) ที่เชื่อมโยงกับผลิตภัณฑ์

gtins[]

string

ไม่บังคับ มี GTIN (หมายเลขสินค้าการค้าสากล) ที่เชื่อมโยงกับผลิตภัณฑ์ ระบบรองรับ GTIN ประเภทย่อย (เช่น UPC, EAN, ISBN, JAN)

mpns[]

string

ไม่บังคับ มี MPN (หมายเลขชิ้นส่วนของผู้ผลิต) ที่เชื่อมโยงกับผลิตภัณฑ์

skus[]

string

ไม่บังคับ มี SKU (สต็อกคีปปิ้งยูนิต) ที่เชื่อมโยงกับผลิตภัณฑ์ ซึ่งมักจะตรงกับรหัสข้อเสนอผลิตภัณฑ์ในฟีดผลิตภัณฑ์

brands[]

string

ไม่บังคับ มีชื่อแบรนด์ที่เชื่อมโยงกับผลิตภัณฑ์

collectionMethod

enum (CollectionMethod)

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

transactionId

string

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

aggregatorName

string

ไม่บังคับ ชื่อผู้รวบรวมข้อมูลรีวิวผลิตภัณฑ์

ผู้เผยแพร่โฆษณาอาจใช้ผู้รวบรวมข้อมูลรีวิวเพื่อจัดการรีวิวและส่งฟีด องค์ประกอบนี้ระบุการใช้ผู้รวบรวมข้อมูลและมีข้อมูลเกี่ยวกับผู้รวบรวมข้อมูล

subclientName

string

ไม่บังคับ ชื่อลูกค้าย่อยของรีวิวผลิตภัณฑ์

โดยข้อมูลลูกค้าย่อยคือตัวระบุแหล่งที่มาของรีวิวผลิตภัณฑ์ ค่านี้ควรเทียบเท่ากับไดเรกทอรีที่ให้ไว้ในเส้นทางแหล่งข้อมูลไฟล์

publisherName

string

ไม่บังคับ ชื่อผู้เผยแพร่รีวิวผลิตภัณฑ์

ข้อมูลเกี่ยวกับผู้เผยแพร่โฆษณา ซึ่งอาจเป็นผู้ค้าปลีก ผู้ผลิต บริษัทบริการรีวิว หรือนิติบุคคลใดก็ตามที่เผยแพร่รีวิวผลิตภัณฑ์

publisherFavicon

string

ไม่บังคับ ลิงก์ไปยัง Favicon ของบริษัทผู้เผยแพร่ ขนาดรูปภาพควรเป็นขนาดไอคอน Fav คือ 16x16 พิกเซล รูปแบบรูปภาพควรเป็น GIF, JPG หรือ PNG

reviewerId

string

ไม่บังคับ ผู้เขียนรีวิวผลิตภัณฑ์

ตัวระบุที่ไม่ซ้ำกันแบบถาวรของผู้เขียนรีวิวในระบบของผู้เผยแพร่โฆษณา

reviewerIsAnonymous

boolean

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

reviewerUsername

string

ไม่บังคับ ชื่อผู้รีวิวรีวิวผลิตภัณฑ์

reviewLanguage

string

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

reviewCountry

string

ไม่บังคับ ประเทศของรีวิวที่ระบุโดยรหัสประเทศ ISO 3166-1 Alpha-2

title

string

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

content

string

ต้องระบุ เนื้อหาของรีวิว

minRating

string (int64 format)

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

maxRating

string (int64 format)

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

rating

number

ไม่บังคับ คะแนนโดยรวมของผู้รีวิวสำหรับผลิตภัณฑ์

isSpam

boolean

ไม่บังคับ ระบุว่ารีวิวมีการทำเครื่องหมายว่าเป็นสแปมในระบบของผู้เผยแพร่โฆษณาหรือไม่

ประเภท

ประเภทของ URI การตรวจสอบ

Enum
TYPE_UNSPECIFIED ยังไม่ระบุประเภท
SINGLETON หน้ารีวิวมีเพียงรีวิวเดียวนี้
GROUP หน้ารีวิวมีกลุ่มรีวิวซึ่งรวมถึงรีวิวนี้

CollectionMethod

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

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

ความรุนแรง

ปัญหาส่งผลต่อการแสดงรีวิวผลิตภัณฑ์อย่างไร

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

เมธอด

delete

ลบรีวิวผลิตภัณฑ์

get

รับการตรวจสอบผลิตภัณฑ์

insert

แทรกรีวิวผลิตภัณฑ์

list

แสดงรีวิวผลิตภัณฑ์