Method: accounts.reports.search

เรียกข้อมูลรายงานที่กำหนดโดยคำค้นหา การตอบกลับอาจมีแถวน้อยกว่าที่ระบุโดย pageSize อาศัย nextPageToken เพื่อดูว่ามีแถวที่จะขอเพิ่มหรือไม่

คำขอ HTTP

POST https://merchantapi.googleapis.com/reports/v1beta/{parent=accounts/*}/reports:search

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
parent

string

ต้องระบุ รหัสบัญชีที่โทร ต้องเป็นบัญชีแบบสแตนด์อโลนหรือบัญชีย่อย MCA รูปแบบ: accounts/{account}

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON 
{
  "query": string,
  "pageSize": integer,
  "pageToken": string
}
ช่อง
query

string

ต้องระบุ คำค้นหาที่กำหนดรายงานที่จะดึงข้อมูล

สำหรับรายละเอียดเกี่ยวกับวิธีสร้างคำค้นหา โปรดดูที่คู่มือภาษาของการค้นหา ดูรายการตารางและฟิลด์ที่ใช้ได้ทั้งหมดที่หัวข้อ "พร้อมใช้งาน"
pageSize

integer

ไม่บังคับ จำนวน ReportRows ที่จะดึงข้อมูลในหน้าเดียว ค่าเริ่มต้นคือ 1,000 ค่าที่มากกว่า 5000 จะถูกเปลี่ยนเป็น 5000
pageToken

string

ไม่บังคับ โทเค็นของหน้าที่จะดึงข้อมูล หากไม่ได้ระบุ ระบบจะแสดงหน้าแรกของผลลัพธ์ หากต้องการขอผลลัพธ์หน้าถัดไป ให้ใช้ค่าที่ได้รับจาก nextPageToken ในคำตอบก่อนหน้า

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับเมธอด ReportService.Search

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "results": [
    {
      object (ReportRow)
    }
  ],
  "nextPageToken": string
}
ช่อง
results[]

object (ReportRow)

แถวที่ตรงกับคำค้นหา
nextPageToken

string

โทเค็นที่สามารถส่งเป็น pageToken เพื่อเรียกข้อมูลหน้าถัดไป หากไม่ระบุ จะไม่มีหน้าถัดไป

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/content

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

ReportRow

แถวผลลัพธ์ที่แสดงจากคำค้นหา

ระบบจะเติมเฉพาะข้อความที่เกี่ยวข้องกับตารางที่ค้นหาในคำตอบ ในข้อความที่มีการเติมข้อมูล ระบบจะเติมเฉพาะฟิลด์ที่ขออย่างชัดแจ้งในการค้นหา

การแสดง JSON 
{
  "productPerformanceView": {
    object (ProductPerformanceView)
  },
  "nonProductPerformanceView": {
    object (NonProductPerformanceView)
  },
  "productView": {
    object (ProductView)
  },
  "priceCompetitivenessProductView": {
    object (PriceCompetitivenessProductView)
  },
  "priceInsightsProductView": {
    object (PriceInsightsProductView)
  },
  "bestSellersProductClusterView": {
    object (BestSellersProductClusterView)
  },
  "bestSellersBrandView": {
    object (BestSellersBrandView)
  },
  "competitiveVisibilityCompetitorView": {
    object (CompetitiveVisibilityCompetitorView)
  },
  "competitiveVisibilityTopMerchantView": {
    object (CompetitiveVisibilityTopMerchantView)
  },
  "competitiveVisibilityBenchmarkView": {
    object (CompetitiveVisibilityBenchmarkView)
  }
}
ช่อง
productPerformanceView

object (ProductPerformanceView)

ฟิลด์ที่มีการค้นหาในตาราง productPerformanceView
nonProductPerformanceView

object (NonProductPerformanceView)

ฟิลด์ที่มีการค้นหาในตาราง nonProductPerformanceView
productView

object (ProductView)

ฟิลด์ที่มีการค้นหาในตาราง productView
priceCompetitivenessProductView

object (PriceCompetitivenessProductView)

ฟิลด์ที่มีการค้นหาในตาราง priceCompetitivenessProductView
priceInsightsProductView

object (PriceInsightsProductView)

ฟิลด์ที่มีการค้นหาในตาราง priceInsightsProductView
bestSellersProductClusterView

object (BestSellersProductClusterView)

ฟิลด์ที่มีการค้นหาในตาราง bestSellersProductClusterView
bestSellersBrandView

object (BestSellersBrandView)

ฟิลด์ที่มีการค้นหาในตาราง bestSellersBrandView
competitiveVisibilityCompetitorView

object (CompetitiveVisibilityCompetitorView)

ฟิลด์ที่มีการค้นหาในตาราง competitiveVisibilityCompetitorView
competitiveVisibilityTopMerchantView

object (CompetitiveVisibilityTopMerchantView)

ฟิลด์ที่มีการค้นหาในตาราง competitiveVisibilityTopMerchantView
competitiveVisibilityBenchmarkView

object (CompetitiveVisibilityBenchmarkView)

ฟิลด์ที่มีการค้นหาในตาราง competitiveVisibilityBenchmarkView

ProductPerformanceView

ฟิลด์ที่มีการค้นหาในตาราง productPerformanceView

ข้อมูลประสิทธิภาพผลิตภัณฑ์สำหรับบัญชี รวมถึงเมตริกประสิทธิภาพ (เช่น clicks) และมิติข้อมูลตามเมตริกประสิทธิภาพที่แบ่งกลุ่ม (เช่น offerId) ค่าของมิติข้อมูลผลิตภัณฑ์ เช่น offerId จะแสดงสถานะของผลิตภัณฑ์ ณ เวลาที่แสดงผล

เลือกช่องกลุ่มในคำค้นหาไม่ได้หากไม่เลือกช่องเมตริกอย่างน้อย 1 ช่อง

ค่าจะกำหนดไว้สำหรับช่องที่ขออย่างชัดแจ้งในคำค้นหาของคำขอเท่านั้น

การแสดง JSON 
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "conversionValue": {
    object (Price)
  },
  "marketingMethod": enum (MarketingMethodEnum),
  "customerCountryCode": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number,
  "conversions": number,
  "conversionRate": number
}
ช่อง
date

object (Date)

วันที่ในเขตเวลาของผู้ขายที่ใช้กับเมตริก กลุ่ม

ต้องระบุเงื่อนไขใน date ในวรรค WHERE
week

object (Date)

วันแรกของสัปดาห์ (วันจันทร์) ของวันที่เมตริกในเขตเวลาของผู้ขาย กลุ่ม
conversionValue

object (Price)

มูลค่าของ Conversion ที่มาจากผลิตภัณฑ์ที่รายงานในวันที่เกิด Conversion เมตริก

ใช้ได้กับแหล่งที่มาของการเข้าชม FREE เท่านั้น
marketingMethod

enum (MarketingMethodEnum)

วิธีทางการตลาดที่จะใช้กับเมตริก กลุ่ม
customerCountryCode

string

รหัสประเทศของลูกค้าในขณะที่เกิดเหตุการณ์ โดยแสดงในรูปแบบ ISO 3166 กลุ่ม

หากไม่สามารถระบุประเทศของลูกค้าได้ ระบบจะส่งรหัส "ZZ" พิเศษกลับมา
offerId

string

รหัสผลิตภัณฑ์ที่ผู้ขายระบุ กลุ่ม
title

string

ชื่อผลิตภัณฑ์ กลุ่ม
brand

string

แบรนด์ของผลิตภัณฑ์ กลุ่ม
categoryL1

string

หมวดหมู่ผลิตภัณฑ์ (ระดับ 1) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google กลุ่ม
categoryL2

string

หมวดหมู่ผลิตภัณฑ์ (ระดับ 2) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google กลุ่ม
categoryL3

string

หมวดหมู่ผลิตภัณฑ์ (ระดับ 3) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google กลุ่ม
categoryL4

string

หมวดหมู่ผลิตภัณฑ์ (ระดับ 4) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google กลุ่ม
categoryL5

string

หมวดหมู่ผลิตภัณฑ์ (ระดับ 5) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google กลุ่ม
productTypeL1

string

ประเภทผลิตภัณฑ์ (ระดับ 1) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง กลุ่ม
productTypeL2

string

ประเภทผลิตภัณฑ์ (ระดับ 2) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง กลุ่ม
productTypeL3

string

ประเภทผลิตภัณฑ์ (ระดับ 3) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง กลุ่ม
productTypeL4

string

ประเภทผลิตภัณฑ์ (ระดับ 4) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง กลุ่ม
productTypeL5

string

ประเภทผลิตภัณฑ์ (ระดับ 5) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง กลุ่ม
customLabel0

string

ป้ายที่กำหนดเอง 0 สำหรับการจัดกลุ่มผลิตภัณฑ์ที่กำหนดเอง กลุ่ม
customLabel1

string

ป้ายที่กำหนดเอง 1 สำหรับการจัดกลุ่มผลิตภัณฑ์ที่กำหนดเอง กลุ่ม
customLabel2

string

ป้ายที่กำหนดเอง 2 สำหรับการจัดกลุ่มผลิตภัณฑ์ที่กำหนดเอง กลุ่ม
customLabel3

string

ป้ายที่กำหนดเอง 3 สำหรับการจัดกลุ่มผลิตภัณฑ์ที่กำหนดเอง กลุ่ม
customLabel4

string

ป้ายที่กำหนดเอง 4 สำหรับการจัดกลุ่มผลิตภัณฑ์ที่กำหนดเอง กลุ่ม
clicks

string (int64 format)

จำนวนคลิก เมตริก
impressions

string (int64 format)

จำนวนครั้งที่ผลิตภัณฑ์ของผู้ขายแสดง เมตริก
clickThroughRate

number

อัตราการคลิกผ่าน - จำนวนคลิกที่ผลิตภัณฑ์ของผู้ขายได้รับ (การคลิก) หารด้วยจำนวนครั้งที่ผลิตภัณฑ์ปรากฏ (การแสดงผล) เมตริก
conversions

number

จำนวน Conversion ที่เกิดจากผลิตภัณฑ์ที่รายงานในวันที่เกิด Conversion Conversion อาจกระจายไปยังหลายๆ คลิก ซึ่งแต่ละคลิกจะได้รับเครดิตของตัวเอง ทั้งนี้ขึ้นอยู่กับรูปแบบการระบุแหล่งที่มา เมตริกนี้คือผลรวมของเครดิตดังกล่าว เมตริก

ใช้ได้กับแหล่งที่มาของการเข้าชม FREE เท่านั้น
conversionRate

number

จำนวน Conversion หารด้วยจำนวนคลิกที่รายงานในวันที่แสดงผล เมตริก

ใช้ได้กับแหล่งที่มาของการเข้าชม FREE เท่านั้น

MarketingMethodEnum

ค่าของวิธีทางการตลาด

Enum
MARKETING_METHOD_ENUM_UNSPECIFIED ไม่ได้ระบุ
ORGANIC การตลาดแบบออร์แกนิก
ADS การตลาดที่อิงตามโฆษณา

NonProductPerformanceView

ฟิลด์ที่มีการค้นหาในตาราง nonProductPerformanceView

ข้อมูลประสิทธิภาพของรูปภาพและลิงก์ร้านค้าออนไลน์ที่นำไปสู่หน้าเว็บที่ไม่เกี่ยวข้องกับผลิตภัณฑ์ของคุณ ซึ่งรวมถึงเมตริกประสิทธิภาพ (เช่น clicks) และมิติข้อมูลตามเมตริกประสิทธิภาพที่แบ่งกลุ่ม (เช่น date)

เลือกช่องกลุ่มในคำค้นหาไม่ได้หากไม่เลือกช่องเมตริกอย่างน้อย 1 ช่อง

ค่าจะกำหนดไว้สำหรับช่องที่ขออย่างชัดแจ้งในคำค้นหาของคำขอเท่านั้น

การแสดง JSON 
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number
}
ช่อง
date

object (Date)

วันที่ในเขตเวลาของผู้ขายที่ใช้กับเมตริก กลุ่ม

ต้องระบุเงื่อนไขใน date ในวรรค WHERE
week

object (Date)

วันแรกของสัปดาห์ (วันจันทร์) ของวันที่เมตริกในเขตเวลาของผู้ขาย กลุ่ม
clicks

string (int64 format)

จำนวนคลิกบนรูปภาพและลิงก์ร้านค้าออนไลน์ที่นำไปสู่หน้าเว็บที่ไม่เกี่ยวข้องกับผลิตภัณฑ์ของคุณ เมตริก
impressions

string (int64 format)

จำนวนครั้งที่รูปภาพและลิงก์ร้านค้าออนไลน์ที่นำไปสู่หน้าผลิตภัณฑ์ที่ไม่ใช่ผลิตภัณฑ์ เมตริก
clickThroughRate

number

อัตราการคลิกผ่าน - จำนวนคลิก (clicks) หารด้วยจำนวนการแสดงผล (impressions) ของรูปภาพและลิงก์ร้านค้าออนไลน์ที่นำไปสู่หน้าผลิตภัณฑ์ที่ไม่ใช่ผลิตภัณฑ์ของคุณ เมตริก

ProductView

ฟิลด์ที่มีการค้นหาในตาราง productView

ผลิตภัณฑ์ในสินค้าคงคลังปัจจุบัน ผลิตภัณฑ์ในตารางนี้เหมือนกับใน API ย่อยของผลิตภัณฑ์ แต่แอตทริบิวต์ของผลิตภัณฑ์จาก API ย่อยของผลิตภัณฑ์บางส่วนเท่านั้นที่จะพร้อมสำหรับการค้นหาในตารางนี้ ตารางนี้ช่วยให้กรองรายการผลิตภัณฑ์ที่ส่งคืนตามแอตทริบิวต์ผลิตภัณฑ์ได้ ซึ่งแตกต่างจาก API ย่อยของผลิตภัณฑ์ หากต้องการเรียกข้อมูลผลิตภัณฑ์เดียวภายในวันที่ id หรือแสดงรายการผลิตภัณฑ์ทั้งหมด ควรใช้ API ย่อยของผลิตภัณฑ์

ค่าจะกำหนดไว้สำหรับช่องที่ขออย่างชัดแจ้งในคำค้นหาของคำขอเท่านั้น

การแสดง JSON 
{
  "price": {
    object (Price)
  },
  "gtin": [
    string
  ],
  "creationTime": string,
  "expirationDate": {
    object (Date)
  },
  "itemIssues": [
    {
      object (ItemIssue)
    }
  ],
  "clickPotential": enum (ClickPotential),
  "id": string,
  "channel": enum (ChannelEnum),
  "languageCode": string,
  "feedLabel": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "condition": string,
  "availability": string,
  "shippingLabel": string,
  "itemGroupId": string,
  "thumbnailLink": string,
  "aggregatedReportingContextStatus": enum (AggregatedReportingContextStatus),
  "clickPotentialRank": string
}
ช่อง
price

object (Price)

ราคาผลิตภัณฑ์ ไม่แสดงหากข้อมูลเกี่ยวกับราคาของผลิตภัณฑ์ไม่พร้อมใช้งาน
gtin[]

string

รายการหมายเลขสินค้าการค้าสากล (GTIN) ของผลิตภัณฑ์
creationTime

string (Timestamp format)

เวลาที่ผู้ขายสร้างผลิตภัณฑ์ในหน่วยวินาทีของการประทับเวลา
expirationDate

object (Date)

วันที่หมดอายุของผลิตภัณฑ์ตามที่ระบุไว้ในการแทรก
itemIssues[]

object (ItemIssue)

รายการปัญหาเกี่ยวกับสินค้าของผลิตภัณฑ์

ช่องนี้ใช้จัดเรียงผลลัพธ์ไม่ได้

ระบบจะใช้เฉพาะแอตทริบิวต์ที่เลือกของช่องนี้ (เช่น itemIssues.severity.aggregated_severity) ในการกรองผลการค้นหา
clickPotential

enum (ClickPotential)

ศักยภาพด้านประสิทธิภาพโดยประมาณเมื่อเทียบกับผลิตภัณฑ์ที่มีประสิทธิภาพสูงสุดของผู้ขาย
id

string

รหัส REST ของผลิตภัณฑ์ในรูปแบบ channel~languageCode~feedLabel~offerId เมธอด Merchant API ที่ทำงานเกี่ยวกับผลิตภัณฑ์จะใช้เมธอดนี้เป็นพารามิเตอร์ name

ต้องระบุในวรรค SELECT
channel

enum (ChannelEnum)

ช่องทางของผลิตภัณฑ์ ซึ่งอาจเป็น ONLINE หรือ LOCAL
languageCode

string

รหัสภาษาของผลิตภัณฑ์ในรูปแบบ BCP 47
feedLabel

string

ป้ายกำกับฟีดของผลิตภัณฑ์
offerId

string

รหัสผลิตภัณฑ์ที่ผู้ขายระบุ
title

string

ชื่อผลิตภัณฑ์
brand

string

แบรนด์ของผลิตภัณฑ์
categoryL1

string

หมวดหมู่ผลิตภัณฑ์ (ระดับ 1) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google
categoryL2

string

หมวดหมู่ผลิตภัณฑ์ (ระดับ 2) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google
categoryL3

string

หมวดหมู่ผลิตภัณฑ์ (ระดับ 3) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google
categoryL4

string

หมวดหมู่ผลิตภัณฑ์ (ระดับ 4) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google
categoryL5

string

หมวดหมู่ผลิตภัณฑ์ (ระดับ 5) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google
productTypeL1

string

ประเภทผลิตภัณฑ์ (ระดับ 1) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง
productTypeL2

string

ประเภทผลิตภัณฑ์ (ระดับ 2) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง
productTypeL3

string

ประเภทผลิตภัณฑ์ (ระดับ 3) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง
productTypeL4

string

ประเภทผลิตภัณฑ์ (ระดับ 4) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง
productTypeL5

string

ประเภทผลิตภัณฑ์ (ระดับ 5) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง
condition

string

สภาพของผลิตภัณฑ์
availability

string

ความพร้อมจำหน่ายสินค้าของผลิตภัณฑ์
shippingLabel

string

ป้ายกำกับการจัดส่งที่ได้รับการปรับให้เป็นมาตรฐานที่ระบุในแหล่งข้อมูล
itemGroupId

string

รหัสกลุ่มสินค้าที่ผู้ขายให้ไว้เพื่อจัดกลุ่มรายละเอียดปลีกย่อยเข้าด้วยกัน
aggregatedReportingContextStatus

enum (AggregatedReportingContextStatus)

สถานะรวม
clickPotentialRank

string (int64 format)

จัดอันดับผลิตภัณฑ์ตามโอกาสที่จะได้รับคลิก ผลิตภัณฑ์ที่มีclickPotentialRank 1 มีโอกาสได้รับคลิกสูงสุดในบรรดาผลิตภัณฑ์ของผู้ขายที่เป็นไปตามเงื่อนไขคำค้นหา

AggregatedReportingContextStatus

สถานะของผลิตภัณฑ์ที่รวบรวมสำหรับบริบทการรายงานทั้งหมด

ต่อไปนี้เป็นตัวอย่างวิธีคำนวณสถานะแบบรวม

ข้อมูลที่แสดงฟรี โฆษณา Shopping สถานะ
Approved Approved มีสิทธิ์
Approved รอดำเนินการ มีสิทธิ์
Approved ไม่อนุมัติ ELIGIBLE_LIMITED
รอดำเนินการ รอดำเนินการ รอดำเนินการ
ไม่อนุมัติ ไม่อนุมัติ NOT_ELIGIBLE_OR_DISAPPROVED
Enum
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED ไม่ได้ระบุ
NOT_ELIGIBLE_OR_DISAPPROVED ผลิตภัณฑ์ไม่มีสิทธิ์หรือไม่ได้รับอนุมัติสำหรับบริบทการรายงานทั้งหมด
PENDING สถานะของผลิตภัณฑ์อยู่ระหว่างรอดำเนินการในบริบทการรายงานทั้งหมด
ELIGIBLE_LIMITED ผลิตภัณฑ์มีสิทธิ์ในบริบทการรายงานบางอย่าง (ไม่ใช่ทั้งหมด)
ELIGIBLE ผลิตภัณฑ์มีสิทธิ์สำหรับบริบทการรายงานทั้งหมด

ItemIssue

ปัญหาเกี่ยวกับสินค้าที่เชื่อมโยงกับผลิตภัณฑ์

การแสดง JSON 
{
  "type": {
    object (ItemIssueType)
  },
  "severity": {
    object (ItemIssueSeverity)
  },
  "resolution": enum (ItemIssueResolution)
}
ช่อง
type

object (ItemIssueType)

ประเภทปัญหาของรายการ
severity

object (ItemIssueSeverity)

ความรุนแรงของปัญหาเกี่ยวกับสินค้า
resolution

enum (ItemIssueResolution)

การแก้ปัญหาเกี่ยวกับสินค้า

ItemIssueType

ประเภทปัญหา

การแสดง JSON 
{
  "code": string,
  "canonicalAttribute": string
}
ช่อง
code

string

รหัสข้อผิดพลาดของปัญหา ซึ่งเทียบเท่ากับ code ของปัญหาเกี่ยวกับผลิตภัณฑ์
canonicalAttribute

string

ชื่อแอตทริบิวต์ Canonical สำหรับปัญหาเฉพาะของแอตทริบิวต์

ItemIssueSeverity

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

การแสดง JSON 
{
  "severityPerReportingContext": [
    {
      object (IssueSeverityPerReportingContext)
    }
  ],
  "aggregatedSeverity": enum (AggregatedIssueSeverity)
}
ช่อง
severityPerReportingContext[]

object (IssueSeverityPerReportingContext)

ความรุนแรงของปัญหาตามบริบทการรายงาน
aggregatedSeverity

enum (AggregatedIssueSeverity)

ความรุนแรงโดยรวมของปัญหาในทุกบริบทการรายงานที่ได้รับผลกระทบ

ช่องนี้ใช้กรองผลการค้นหาได้

IssueSeverityPerReportingContext

ความรุนแรงของปัญหาตามบริบทการรายงาน

การแสดง JSON 
{
  "disapprovedCountries": [
    string
  ],
  "demotedCountries": [
    string
  ],
  "reportingContext": enum (ReportingContextEnum)
}
ช่อง
disapprovedCountries[]

string

รายชื่อประเทศที่ไม่ได้รับอนุมัติในบริบทการรายงาน แสดงในรูปแบบ ISO 3166
demotedCountries[]

string

รายชื่อประเทศที่ถูกลดระดับในบริบทการรายงาน แสดงในรูปแบบ ISO 3166
reportingContext

enum (ReportingContextEnum)

บริบทการรายงานที่เป็นปัญหา

AggregatedIssueSeverity

ความรุนแรงของปัญหาที่รวบรวมมาสำหรับบริบทการรายงานทั้งหมด

Enum
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED ไม่ได้ระบุ
DISAPPROVED ปัญหาไม่อนุมัติผลิตภัณฑ์ในบริบทการรายงานอย่างน้อย 1 รายการ
DEMOTED ปัญหาจะลดระดับผลิตภัณฑ์ในบริบทการรายงานทั้งหมดที่ได้รับผลกระทบ
PENDING การแก้ไขปัญหาคือ PENDING_PROCESSING

ItemIssueResolution

วิธีแก้ไขปัญหา

Enum
ITEM_ISSUE_RESOLUTION_UNSPECIFIED ไม่ได้ระบุ
MERCHANT_ACTION ผู้ขายต้องแก้ไขปัญหา
PENDING_PROCESSING ปัญหาจะได้รับการแก้ไขโดยอัตโนมัติ (เช่น การ Crawl รูปภาพ) หรือผ่านการตรวจสอบของ Google ผู้ขายไม่จำเป็นต้องดำเนินการใดๆ ในขณะนี้ การแก้ปัญหาอาจทำให้เกิดปัญหาอื่น (เช่น หากทำการ Crawl ไม่สำเร็จ)

ClickPotential

โอกาสที่จะได้รับคลิกของผลิตภัณฑ์จะประมาณประสิทธิภาพที่เป็นไปได้เมื่อเทียบกับผลิตภัณฑ์ที่มีประสิทธิภาพสูงสุดของผู้ขาย ช่วยให้ผู้ขายจัดลําดับความสําคัญของผลิตภัณฑ์ที่ต้องแก้ไขและช่วยให้เข้าใจประสิทธิภาพของผลิตภัณฑ์ตามศักยภาพที่เป็นไปได้

Enum
CLICK_POTENTIAL_UNSPECIFIED ผลกระทบการคลิกที่คาดการณ์ที่ไม่รู้จัก
LOW มีโอกาสที่จะได้รับยอดคลิกน้อยเมื่อเทียบกับผลิตภัณฑ์ที่มีประสิทธิภาพสูงสุดของผู้ขาย
MEDIUM มีโอกาสที่จะได้รับยอดคลิกปานกลางเมื่อเทียบกับผลิตภัณฑ์ที่มีประสิทธิภาพสูงสุดของผู้ขาย
HIGH มีโอกาสที่จะได้รับยอดคลิกใกล้เคียงกับผลิตภัณฑ์ที่มีประสิทธิภาพสูงสุดของผู้ขาย

PriceCompetitivenessProductView

ฟิลด์ที่มีการค้นหาในตาราง priceCompetitivenessProductView

รายงานความสามารถในการแข่งขันด้านราคา

ค่าจะกำหนดไว้สำหรับช่องที่ขออย่างชัดแจ้งในคำค้นหาของคำขอเท่านั้น

การแสดง JSON 
{
  "price": {
    object (Price)
  },
  "benchmarkPrice": {
    object (Price)
  },
  "reportCountryCode": string,
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string
}
ช่อง
price

object (Price)

ราคาปัจจุบันของผลิตภัณฑ์
benchmarkPrice

object (Price)

การเปรียบเทียบราคาล่าสุดที่พร้อมใช้งานสำหรับแคตตาล็อกของผลิตภัณฑ์ในประเทศที่ใช้เปรียบเทียบ
reportCountryCode

string

ประเทศที่มีราคาเปรียบเทียบ โดยแสดงในรูปแบบ ISO 3166

ต้องระบุในวรรค SELECT
id

string

รหัส REST ของผลิตภัณฑ์ในรูปแบบ channel~languageCode~feedLabel~offerId ใช้เพื่อผูกข้อมูลกับตาราง productView ได้

ต้องระบุในวรรค SELECT
offerId

string

รหัสผลิตภัณฑ์ที่ผู้ขายระบุ
title

string

ชื่อผลิตภัณฑ์
brand

string

แบรนด์ของผลิตภัณฑ์
categoryL1

string

หมวดหมู่ผลิตภัณฑ์ (ระดับ 1) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google
categoryL2

string

หมวดหมู่ผลิตภัณฑ์ (ระดับ 2) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google
categoryL3

string

หมวดหมู่ผลิตภัณฑ์ (ระดับ 3) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google
categoryL4

string

หมวดหมู่ผลิตภัณฑ์ (ระดับ 4) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google
categoryL5

string

หมวดหมู่ผลิตภัณฑ์ (ระดับ 5) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google
productTypeL1

string

ประเภทผลิตภัณฑ์ (ระดับ 1) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง
productTypeL2

string

ประเภทผลิตภัณฑ์ (ระดับ 2) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง
productTypeL3

string

ประเภทผลิตภัณฑ์ (ระดับ 3) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง
productTypeL4

string

ประเภทผลิตภัณฑ์ (ระดับ 4) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง
productTypeL5

string

ประเภทผลิตภัณฑ์ (ระดับ 5) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง

PriceInsightsProductView

ฟิลด์ที่มีการค้นหาในตาราง priceInsightsProductView

รายงานข้อมูลเชิงลึกด้านราคา

ค่าจะกำหนดไว้สำหรับช่องที่ขออย่างชัดแจ้งในคำค้นหาของคำขอเท่านั้น

การแสดง JSON 
{
  "price": {
    object (Price)
  },
  "suggestedPrice": {
    object (Price)
  },
  "effectiveness": enum (Effectiveness),
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "predictedImpressionsChangeFraction": number,
  "predictedClicksChangeFraction": number,
  "predictedConversionsChangeFraction": number
}
ช่อง
price

object (Price)

ราคาปัจจุบันของผลิตภัณฑ์
suggestedPrice

object (Price)

ราคาที่แนะนำล่าสุดของผลิตภัณฑ์
effectiveness

enum (Effectiveness)

ประสิทธิภาพที่คาดการณ์ไว้ของการใช้คำแนะนำราคา (รวบรวมไว้)
id

string

รหัส REST ของผลิตภัณฑ์ในรูปแบบ channel~languageCode~feedLabel~offerId ใช้เพื่อผูกข้อมูลกับตาราง productView ได้

ต้องระบุในวรรค SELECT
offerId

string

รหัสผลิตภัณฑ์ที่ผู้ขายระบุ
title

string

ชื่อผลิตภัณฑ์
brand

string

แบรนด์ของผลิตภัณฑ์
categoryL1

string

หมวดหมู่ผลิตภัณฑ์ (ระดับ 1) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google
categoryL2

string

หมวดหมู่ผลิตภัณฑ์ (ระดับ 2) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google
categoryL3

string

หมวดหมู่ผลิตภัณฑ์ (ระดับ 3) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google
categoryL4

string

หมวดหมู่ผลิตภัณฑ์ (ระดับ 4) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google
categoryL5

string

หมวดหมู่ผลิตภัณฑ์ (ระดับ 5) ในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google
productTypeL1

string

ประเภทผลิตภัณฑ์ (ระดับ 1) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง
productTypeL2

string

ประเภทผลิตภัณฑ์ (ระดับ 2) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง
productTypeL3

string

ประเภทผลิตภัณฑ์ (ระดับ 3) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง
productTypeL4

string

ประเภทผลิตภัณฑ์ (ระดับ 4) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง
productTypeL5

string

ประเภทผลิตภัณฑ์ (ระดับ 5) ในการจัดหมวดหมู่ผลิตภัณฑ์ของผู้ขายเอง
predictedImpressionsChangeFraction

number

การเปลี่ยนแปลงที่คาดการณ์ของการแสดงผลเป็นเศษส่วนหลังจากแนะนำราคาที่แนะนำเมื่อเทียบกับราคาที่ใช้งานอยู่ในปัจจุบัน เช่น 0.05 คือจำนวนการแสดงผลที่คาดว่าจะเพิ่มขึ้น 5%
predictedClicksChangeFraction

number

การเปลี่ยนแปลงที่คาดการณ์ของจำนวนคลิกเป็นเศษส่วนหลังจากแนะนำราคาที่แนะนำเมื่อเทียบกับราคาที่ใช้งานอยู่ปัจจุบัน เช่น 0.05 คือจำนวนคลิกที่คาดว่าจะเพิ่มขึ้น 5%
predictedConversionsChangeFraction

number

การเปลี่ยนแปลงที่คาดการณ์ไว้ของ Conversion เป็นเศษส่วนหลังจากแนะนำราคาที่แนะนำเมื่อเทียบกับราคาที่ใช้งานอยู่ปัจจุบัน เช่น 0.05 คือ Conversion ที่คาดว่าจะเพิ่มขึ้น 5%)

ประสิทธิภาพ

ที่เก็บข้อมูลประสิทธิภาพที่คาดการณ์ไว้

ประสิทธิภาพจะระบุว่าผลิตภัณฑ์ใดจะได้รับประโยชน์มากที่สุดจากการเปลี่ยนแปลงราคา คะแนนนี้จะพิจารณาการเพิ่มประสิทธิภาพที่คาดการณ์ด้วยการปรับราคาลดและความแตกต่างระหว่างราคาปัจจุบันของคุณกับราคาที่แนะนำ ระบบคาดการณ์ว่าราคาที่แนะนำซึ่งมีประสิทธิผล HIGH จะช่วยเพิ่มประสิทธิภาพได้มากที่สุด

Enum
EFFECTIVENESS_UNSPECIFIED ไม่ทราบประสิทธิภาพ
LOW ประสิทธิภาพต่ำ
MEDIUM ประสิทธิภาพอยู่ในระดับปานกลาง
HIGH ประสิทธิภาพอยู่ในระดับสูง

BestSellersProductClusterView

ฟิลด์ที่มีการค้นหาในตาราง bestSellersProductClusterView

รายงานสินค้าขายดีพร้อมคลัสเตอร์ผลิตภัณฑ์ยอดนิยม คลัสเตอร์ผลิตภัณฑ์คือการจัดกลุ่มข้อเสนอและรายละเอียดปลีกย่อยต่างๆ ที่แสดงถึงผลิตภัณฑ์เดียวกัน เช่น Google Pixel 7

ค่าจะกำหนดไว้สำหรับช่องที่ขออย่างชัดแจ้งในคำค้นหาของคำขอเท่านั้น

การแสดง JSON 
{
  "reportDate": {
    object (Date)
  },
  "variantGtins": [
    string
  ],
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "inventoryStatus": enum (InventoryStatus),
  "brandInventoryStatus": enum (InventoryStatus),
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
ช่อง
reportDate

object (Date)

วันที่รายงาน ค่าของช่องนี้ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น

  • วันแรกของสัปดาห์ (วันจันทร์) สำหรับรายงานรายสัปดาห์
  • วันแรกของเดือนสำหรับรายงานรายเดือน

ต้องระบุในวรรค SELECT หากไม่ได้ระบุเงื่อนไข WHERE ใน reportDate ในคำค้นหา ระบบจะแสดงผลรายงานรายสัปดาห์หรือรายเดือนล่าสุดที่มี
variantGtins[]

string

GTIN ของตัวอย่างรายละเอียดปลีกย่อยของคลัสเตอร์ผลิตภัณฑ์
reportGranularity

enum (ReportGranularityEnum)

รายละเอียดของรายงาน การจัดอันดับอาจมีผลในช่วง 1 สัปดาห์หรือ 1 เดือน

ต้องระบุในวรรค SELECT ต้องระบุเงื่อนไขใน reportGranularity ในวรรค WHERE
reportCountryCode

string

ประเทศที่คำนวณการจัดอันดับ โดยแสดงในรูปแบบ ISO 3166

ต้องระบุในวรรค SELECT ต้องระบุเงื่อนไขใน reportCountryCode ในวรรค WHERE
reportCategoryId

string (int64 format)

รหัสหมวดหมู่ผลิตภัณฑ์ Google สำหรับคำนวณการจัดอันดับ ซึ่งแสดงในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

ต้องระบุในวรรค SELECT หากไม่มีการระบุเงื่อนไข WHERE ใน reportCategoryId ในข้อความค้นหา ระบบจะแสดงการจัดอันดับสำหรับหมวดหมู่ระดับบนสุดทั้งหมด
title

string

ชื่อของคลัสเตอร์ผลิตภัณฑ์
brand

string

แบรนด์ของคลัสเตอร์ผลิตภัณฑ์
categoryL1

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 1) ของคลัสเตอร์ผลิตภัณฑ์ซึ่งแสดงในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google
categoryL2

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 2) ของคลัสเตอร์ผลิตภัณฑ์ซึ่งแสดงในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google
categoryL3

string

หมวดหมู่ผลิตภัณฑ์ (ระดับ 3) ของคลัสเตอร์ผลิตภัณฑ์ซึ่งแสดงในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google
categoryL4

string

หมวดหมู่ผลิตภัณฑ์ (ระดับ 4) ของคลัสเตอร์ผลิตภัณฑ์ซึ่งแสดงในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google
categoryL5

string

หมวดหมู่ผลิตภัณฑ์ (ระดับที่ 5) ของคลัสเตอร์ผลิตภัณฑ์ซึ่งแสดงในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google
inventoryStatus

enum (InventoryStatus)

ระบุว่าคลัสเตอร์ผลิตภัณฑ์คือ IN_STOCK ในแหล่งข้อมูลผลิตภัณฑ์ในประเทศอย่างน้อย 1 ประเทศ OUT_OF_STOCK ในแหล่งข้อมูลผลิตภัณฑ์ในทุกประเทศ หรือ NOT_IN_INVENTORY เลย

โดยไม่ได้นำตัวกรองประเทศของรายงานสินค้าขายดีมาพิจารณาด้วย
brandInventoryStatus

enum (InventoryStatus)

ดูว่าขณะนี้มีผลิตภัณฑ์ของแบรนด์อย่างน้อย 1 รายการซึ่งIN_STOCKอยู่ในแหล่งข้อมูลผลิตภัณฑ์ในอย่างน้อย 1 ประเทศหรือไม่ ผลิตภัณฑ์ทั้งหมดก็อยู่ในแหล่งข้อมูลผลิตภัณฑ์ OUT_OF_STOCK ในทุกประเทศ หรือ NOT_IN_INVENTORY

โดยไม่ได้นำตัวกรองประเทศของรายงานสินค้าขายดีมาพิจารณาด้วย
rank

string (int64 format)

ความนิยมของคลัสเตอร์ผลิตภัณฑ์บนโฆษณาและแพลตฟอร์มทั่วไปในหมวดหมู่และประเทศที่เลือกโดยอิงจากจำนวนหน่วยที่ขายโดยประมาณ
previousRank

string (int64 format)

อันดับความนิยมในสัปดาห์หรือเดือนที่ผ่านมา
relativeDemand

enum (RelativeDemandEnum)

ความต้องการโดยประมาณซึ่งสัมพันธ์กับคลัสเตอร์ผลิตภัณฑ์ที่มีอันดับความนิยมสูงสุดในหมวดหมู่และประเทศเดียวกัน
previousRelativeDemand

enum (RelativeDemandEnum)

ความต้องการโดยประมาณซึ่งสัมพันธ์กับคลัสเตอร์ผลิตภัณฑ์ที่มีอันดับความนิยมสูงสุดในหมวดหมู่และประเทศเดียวกันในสัปดาห์หรือเดือนก่อนหน้า
relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

การเปลี่ยนแปลงของความต้องการโดยประมาณ เช่น สูงขึ้น จม หรือคงตัว

ReportGranularityEnum

รายงานค่ารายละเอียด

Enum
REPORT_GRANULARITY_ENUM_UNSPECIFIED ไม่ได้ระบุ
WEEKLY รายงานจะคำนวณในระยะเวลา 1 สัปดาห์
MONTHLY รายงานจะคำนวณในระยะเวลา 1 เดือน

InventoryStatus

สถานะของคลัสเตอร์หรือแบรนด์ผลิตภัณฑ์ในสินค้าคงคลัง

Enum
INVENTORY_STATUS_UNSPECIFIED ไม่ได้ระบุ
IN_STOCK คุณมีผลิตภัณฑ์สำหรับคลัสเตอร์หรือแบรนด์ผลิตภัณฑ์นี้พร้อมจำหน่าย
OUT_OF_STOCK คุณมีผลิตภัณฑ์สำหรับคลัสเตอร์หรือแบรนด์ผลิตภัณฑ์นี้ในสินค้าคงคลัง แต่ขณะนี้สินค้าหมด
NOT_IN_INVENTORY คุณไม่มีผลิตภัณฑ์สำหรับคลัสเตอร์ผลิตภัณฑ์หรือแบรนด์นี้ในสินค้าคงคลัง

RelativeDemandEnum

ค่าความต้องการแบบสัมพัทธ์

Enum
RELATIVE_DEMAND_ENUM_UNSPECIFIED ไม่ได้ระบุ
VERY_LOW ความต้องการคิดเป็น 0-5% ของความต้องการของแบรนด์หรือคลัสเตอร์ผลิตภัณฑ์หรือแบรนด์ที่มีอันดับสูงสุด
LOW ความต้องการคิดเป็น 6-10% ของความต้องการของกลุ่มผลิตภัณฑ์หรือแบรนด์ที่มีอันดับสูงสุด
MEDIUM ความต้องการคิดเป็น 11-20% ของความต้องการของกลุ่มผลิตภัณฑ์หรือแบรนด์ที่มีอันดับสูงสุด
HIGH ความต้องการคิดเป็น 21-50% ของความต้องการของกลุ่มผลิตภัณฑ์หรือแบรนด์ที่มีอันดับสูงสุด
VERY_HIGH ความต้องการคิดเป็น 51-100% ของความต้องการของกลุ่มผลิตภัณฑ์หรือแบรนด์ที่มีอันดับสูงสุด

RelativeDemandChangeTypeEnum

ค่าประเภทการเปลี่ยนแปลงของความต้องการแบบสัมพัทธ์

Enum
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED ไม่ได้ระบุ
SINKER ความต้องการแบบสัมพัทธ์ต่ำกว่าระยะเวลาก่อนหน้า
FLAT ความต้องการแบบสัมพัทธ์จะเท่ากับระยะเวลาก่อนหน้า
RISER ความต้องการแบบสัมพัทธ์สูงกว่าระยะเวลาก่อนหน้า

BestSellersBrandView

ฟิลด์ที่มีการค้นหาในตาราง bestSellersBrandView

รายงานสินค้าขายดีของแบรนด์ชั้นนำ

ค่าจะกำหนดไว้สำหรับช่องที่ขออย่างชัดแจ้งในคำค้นหาของคำขอเท่านั้น

การแสดง JSON 
{
  "reportDate": {
    object (Date)
  },
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "brand": string,
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
ช่อง
reportDate

object (Date)

วันที่รายงาน ค่าของช่องนี้ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น

  • วันแรกของสัปดาห์ (วันจันทร์) สำหรับรายงานรายสัปดาห์
  • วันแรกของเดือนสำหรับรายงานรายเดือน

ต้องระบุในวรรค SELECT หากไม่ได้ระบุเงื่อนไข WHERE ใน reportDate ในคำค้นหา ระบบจะแสดงผลรายงานรายสัปดาห์หรือรายเดือนล่าสุดที่มี
reportGranularity

enum (ReportGranularityEnum)

รายละเอียดของรายงาน การจัดอันดับอาจมีผลในช่วง 1 สัปดาห์หรือ 1 เดือน

ต้องระบุในวรรค SELECT ต้องระบุเงื่อนไขใน reportGranularity ในวรรค WHERE
reportCountryCode

string

ประเทศที่คำนวณการจัดอันดับ โดยแสดงในรูปแบบ ISO 3166

ต้องระบุในวรรค SELECT ต้องระบุเงื่อนไขใน reportCountryCode ในวรรค WHERE
reportCategoryId

string (int64 format)

รหัสหมวดหมู่ผลิตภัณฑ์ Google สำหรับคำนวณการจัดอันดับ ซึ่งแสดงในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

ต้องระบุในวรรค SELECT หากไม่มีการระบุเงื่อนไข WHERE ใน reportCategoryId ในข้อความค้นหา ระบบจะแสดงการจัดอันดับสำหรับหมวดหมู่ระดับบนสุดทั้งหมด
brand

string

ชื่อแบรนด์
rank

string (int64 format)

ความนิยมของแบรนด์ในโฆษณาและแพลตฟอร์มการค้นหาทั่วไปตามหมวดหมู่และประเทศที่เลือกโดยอิงจากจำนวนหน่วยที่ขายโดยประมาณ
previousRank

string (int64 format)

อันดับความนิยมในสัปดาห์หรือเดือนที่ผ่านมา
relativeDemand

enum (RelativeDemandEnum)

ความต้องการโดยประมาณที่เกี่ยวข้องกับแบรนด์ที่มีอันดับความนิยมสูงสุดในหมวดหมู่และประเทศเดียวกัน
previousRelativeDemand

enum (RelativeDemandEnum)

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

enum (RelativeDemandChangeTypeEnum)

การเปลี่ยนแปลงของความต้องการโดยประมาณ เช่น สูงขึ้น จม หรือคงตัว

CompetitiveVisibilityCompetitorView

ฟิลด์ที่มีการค้นหาในตาราง competitiveVisibilityCompetitorView

รายงานการแสดงผลเทียบกับคู่แข่งกับธุรกิจที่มีการแสดงผลคล้ายกัน

ค่าจะกำหนดไว้สำหรับช่องที่ขออย่างชัดแจ้งในคำค้นหาของคำขอเท่านั้น

การแสดง JSON 
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number,
  "relativeVisibility": number
}
ช่อง
date

object (Date)

วันที่ของแถวนี้

ต้องมีเงื่อนไขใน date ในวรรค WHERE
domain

string

โดเมนของคู่แข่งหรือโดเมนของคุณ หาก 'isYourDomain' เป็นจริง

ต้องระบุในวรรค SELECT กรองในประโยค "WHERE" ไม่ได้
isYourDomain

boolean

เป็นจริงหากแถวนี้มีข้อมูลสำหรับโดเมนของคุณ

กรองในประโยค "WHERE" ไม่ได้
reportCountryCode

string

ประเทศที่การแสดงผลปรากฏ

ต้องระบุในวรรค SELECT ต้องมีเงื่อนไขใน reportCountryCode ในวรรค WHERE
reportCategoryId

string (int64 format)

รหัสหมวดหมู่ผลิตภัณฑ์ Google เพื่อคำนวณรายงาน ซึ่งแสดงในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

ต้องระบุในวรรค SELECT ต้องมีเงื่อนไขใน reportCategoryId ในวรรค WHERE
trafficSource

enum (TrafficSourceEnum)

แหล่งที่มาของการเข้าชม

ต้องระบุในวรรค SELECT
rank

string (int64 format)

ตำแหน่งของโดเมนในการจัดอันดับธุรกิจที่คล้ายกันสำหรับคีย์ที่เลือก (date, reportCategoryId, reportCountryCode, trafficSource) โดยอิงตามการแสดงผล 1 คือค่าสูงสุด

กรองในประโยค "WHERE" ไม่ได้
adsOrganicRatio

number

อัตราส่วนโฆษณา / การค้นหาทั่วไปแสดงความถี่ที่โดเมนได้รับการแสดงผลจากโฆษณา Shopping เทียบกับการเข้าชมจากการค้นหาทั่วไป ระบบจะปัดเศษตัวเลขและเก็บข้อมูลไว้

กรองในประโยค "WHERE" ไม่ได้
pageOverlapRate

number

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

กรองในประโยค "WHERE" ไม่ได้
higherPositionRate

number

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

กรองในประโยค "WHERE" ไม่ได้
relativeVisibility

number

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

กรองในประโยค "WHERE" ไม่ได้

TrafficSourceEnum

ค่าแหล่งที่มาของการเข้าชม

Enum
TRAFFIC_SOURCE_ENUM_UNSPECIFIED ไม่ได้ระบุ
ORGANIC การเข้าชมจากการค้นหาทั่วไป
ADS การเข้าชมจากโฆษณา
ALL การเข้าชมจากการค้นหาทั่วไปและการเข้าชมจากโฆษณา

CompetitiveVisibilityTopMerchantView

ฟิลด์ที่มีการค้นหาในตาราง competitiveVisibilityTopMerchantView

รายงานการแสดงผลเทียบกับคู่แข่งกับธุรกิจที่มีการแสดงผลสูงสุด

ค่าจะกำหนดไว้สำหรับช่องที่ขออย่างชัดแจ้งในคำค้นหาของคำขอเท่านั้น

การแสดง JSON 
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number
}
ช่อง
date

object (Date)

วันที่ของแถวนี้

ไม่สามารถเลือกในวรรคเงื่อนไข SELECT ต้องมีเงื่อนไขใน date ในวรรค WHERE
domain

string

โดเมนของคู่แข่งหรือโดเมนของคุณ หาก 'isYourDomain' เป็นจริง

ต้องระบุในวรรค SELECT กรองในประโยค "WHERE" ไม่ได้
isYourDomain

boolean

เป็นจริงหากแถวนี้มีข้อมูลสำหรับโดเมนของคุณ

กรองในประโยค "WHERE" ไม่ได้
reportCountryCode

string

ประเทศที่การแสดงผลปรากฏ

ต้องระบุในวรรค SELECT ต้องมีเงื่อนไขใน reportCountryCode ในวรรค WHERE
reportCategoryId

string (int64 format)

รหัสหมวดหมู่ผลิตภัณฑ์ Google เพื่อคำนวณรายงาน ซึ่งแสดงในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

ต้องระบุในวรรค SELECT ต้องมีเงื่อนไขใน reportCategoryId ในวรรค WHERE
trafficSource

enum (TrafficSourceEnum)

แหล่งที่มาของการเข้าชม

ต้องระบุในวรรค SELECT
rank

string (int64 format)

ตำแหน่งของโดเมนในการจัดอันดับผู้ขายยอดนิยมสำหรับคีย์ที่เลือก (date, reportCategoryId, reportCountryCode, trafficSource) ซึ่งอิงตามการแสดงผล 1 คือค่าสูงสุด

กรองในประโยค "WHERE" ไม่ได้
adsOrganicRatio

number

อัตราส่วนโฆษณา / การค้นหาทั่วไปแสดงความถี่ที่โดเมนได้รับการแสดงผลจากโฆษณา Shopping เทียบกับการเข้าชมจากการค้นหาทั่วไป ระบบจะปัดเศษตัวเลขและเก็บข้อมูลไว้

กรองในประโยค "WHERE" ไม่ได้
pageOverlapRate

number

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

กรองในประโยค "WHERE" ไม่ได้
higherPositionRate

number

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

กรองในประโยค "WHERE" ไม่ได้

CompetitiveVisibilityBenchmarkView

ฟิลด์ที่มีการค้นหาในตาราง competitiveVisibilityBenchmarkView

รายงานการแสดงผลเทียบกับคู่แข่งพร้อมการเปรียบเทียบหมวดหมู่

ค่าจะกำหนดไว้สำหรับช่องที่ขออย่างชัดแจ้งในคำค้นหาของคำขอเท่านั้น

การแสดง JSON 
{
  "date": {
    object (Date)
  },
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "yourDomainVisibilityTrend": number,
  "categoryBenchmarkVisibilityTrend": number
}
ช่อง
date

object (Date)

วันที่ของแถวนี้

ต้องระบุในวรรค SELECT ต้องมีเงื่อนไขใน date ในวรรค WHERE
reportCountryCode

string

ประเทศที่การแสดงผลปรากฏ

ต้องระบุในวรรค SELECT ต้องมีเงื่อนไขใน reportCountryCode ในวรรค WHERE
reportCategoryId

string (int64 format)

รหัสหมวดหมู่ผลิตภัณฑ์ Google เพื่อคำนวณรายงาน ซึ่งแสดงในการจัดหมวดหมู่ผลิตภัณฑ์ของ Google

ต้องระบุในวรรค SELECT ต้องมีเงื่อนไขใน reportCategoryId ในวรรค WHERE
trafficSource

enum (TrafficSourceEnum)

แหล่งที่มาของการเข้าชม

ต้องระบุในวรรค SELECT
yourDomainVisibilityTrend

number

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

กรองในประโยค "WHERE" ไม่ได้
categoryBenchmarkVisibilityTrend

number

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

กรองในประโยค "WHERE" ไม่ได้