Package google.shopping.merchant.reports.v1beta

ดัชนี

ReportService

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

ค้นหา

rpc Search(SearchRequest) returns (SearchResponse)

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

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

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

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

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

BestSellersBrandView

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

รายงานสินค้าขายดีที่แสดงแบรนด์ยอดนิยม

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

ช่อง
report_date

Date

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

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

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

report_granularity

ReportGranularityEnum

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

ต้องระบุในอนุประโยค SELECT ต้องมีเงื่อนไข report_granularity ในอนุประโยค WHERE

report_country_code

string

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

ต้องระบุในอนุประโยค SELECT ต้องมีเงื่อนไข report_country_code ในอนุประโยค WHERE

report_category_id

int64

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

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

brand

string

ชื่อแบรนด์

rank

int64

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

previous_rank

int64

อันดับความนิยมในสัปดาห์หรือเดือนก่อนหน้า

relative_demand

RelativeDemandEnum

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

previous_relative_demand

RelativeDemandEnum

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

relative_demand_change

RelativeDemandChangeTypeEnum

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

BestSellersProductClusterView

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

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

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

ช่อง
report_date

Date

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

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

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

variant_gtins[]

string

GTIN ของผลิตภัณฑ์ย่อยตัวอย่างของคลัสเตอร์ผลิตภัณฑ์

report_granularity

ReportGranularityEnum

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

ต้องระบุในอนุประโยค SELECT ต้องมีเงื่อนไข report_granularity ในอนุประโยค WHERE

report_country_code

string

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

ต้องระบุในอนุประโยค SELECT ต้องมีเงื่อนไข report_country_code ในอนุประโยค WHERE

report_category_id

int64

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

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

title

string

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

brand

string

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

category_l1

string

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

category_l2

string

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

category_l3

string

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

category_l4

string

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

category_l5

string

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

inventory_status

InventoryStatus

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

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

brand_inventory_status

InventoryStatus

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

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

rank

int64

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

previous_rank

int64

อันดับความนิยมในสัปดาห์หรือเดือนก่อนหน้า

relative_demand

RelativeDemandEnum

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

previous_relative_demand

RelativeDemandEnum

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

relative_demand_change

RelativeDemandChangeTypeEnum

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

InventoryStatus

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

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

CompetitiveVisibilityBenchmarkView

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

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

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

ช่อง
date

Date

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

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

report_country_code

string

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

ต้องระบุในอนุประโยค SELECT ต้องมีเงื่อนไขใน report_country_code ในวลี WHERE

report_category_id

int64

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

ต้องระบุในอนุประโยค SELECT ต้องมีเงื่อนไขใน report_category_id ในวลี WHERE

traffic_source

TrafficSourceEnum

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

ต้องระบุในอนุประโยค SELECT

your_domain_visibility_trend

double

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

ไม่สามารถกรองในคำสั่ง "WHERE"

category_benchmark_visibility_trend

double

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

ไม่สามารถกรองในคำสั่ง "WHERE"

CompetitiveVisibilityCompetitorView

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

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

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

ช่อง
date

Date

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

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

domain

string

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

ต้องระบุในอนุประโยค SELECT ไม่สามารถกรองในคำสั่ง "WHERE"

is_your_domain

bool

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

ไม่สามารถกรองในคำสั่ง "WHERE"

report_country_code

string

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

ต้องระบุในอนุประโยค SELECT ต้องมีเงื่อนไขใน report_country_code ในวลี WHERE

report_category_id

int64

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

ต้องระบุในอนุประโยค SELECT ต้องมีเงื่อนไขใน report_category_id ในวลี WHERE

traffic_source

TrafficSourceEnum

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

ต้องระบุในอนุประโยค SELECT

rank

int64

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

ไม่สามารถกรองในคำสั่ง "WHERE"

ads_organic_ratio

double

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

ไม่สามารถกรองในคำสั่ง "WHERE"

page_overlap_rate

double

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

ไม่สามารถกรองในคำสั่ง "WHERE"

higher_position_rate

double

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

ไม่สามารถกรองในคำสั่ง "WHERE"

relative_visibility

double

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

ไม่สามารถกรองในคำสั่ง "WHERE"

CompetitiveVisibilityTopMerchantView

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

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

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

ช่อง
date

Date

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

เลือกในวลี SELECT ไม่ได้ ต้องมีเงื่อนไขใน date ในวลี WHERE

domain

string

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

ต้องระบุในอนุประโยค SELECT ไม่สามารถกรองในคำสั่ง "WHERE"

is_your_domain

bool

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

ไม่สามารถกรองในคำสั่ง "WHERE"

report_country_code

string

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

ต้องระบุในอนุประโยค SELECT ต้องมีเงื่อนไขใน report_country_code ในวลี WHERE

report_category_id

int64

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

ต้องระบุในอนุประโยค SELECT ต้องมีเงื่อนไขใน report_category_id ในวลี WHERE

traffic_source

TrafficSourceEnum

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

ต้องระบุในอนุประโยค SELECT

rank

int64

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

ไม่สามารถกรองในคำสั่ง "WHERE"

ads_organic_ratio

double

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

ไม่สามารถกรองในคำสั่ง "WHERE"

page_overlap_rate

double

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

ไม่สามารถกรองในคำสั่ง "WHERE"

higher_position_rate

double

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

ไม่สามารถกรองในคำสั่ง "WHERE"

MarketingMethod

ประเภทนี้ไม่มีช่อง

วิธีทางการตลาดที่ใช้ในการโปรโมตผลิตภัณฑ์ของคุณบน Google (ทั่วไปเทียบกับโฆษณา)

MarketingMethodEnum

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

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

NonProductPerformanceView

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

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

ไม่สามารถเลือกช่องกลุ่มในข้อความค้นหาหากไม่เลือกช่องเมตริกอย่างน้อย 1 ช่อง

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

ช่อง
date

Date

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

ต้องมีเงื่อนไข date ในอนุประโยค WHERE

week

Date

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

clicks

int64

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

impressions

int64

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

click_through_rate

double

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

PriceCompetitivenessProductView

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

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

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

ช่อง
price

Price

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

benchmark_price

Price

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

report_country_code

string

ประเทศของการเปรียบเทียบราคา จะแสดงในรูปแบบ ISO 3166

ต้องระบุในอนุประโยค SELECT

id

string

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

ต้องระบุในอนุประโยค SELECT

offer_id

string

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

title

string

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

brand

string

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

category_l1

string

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

category_l2

string

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

category_l3

string

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

category_l4

string

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

category_l5

string

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

product_type_l1

string

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

product_type_l2

string

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

product_type_l3

string

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

product_type_l4

string

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

product_type_l5

string

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

PriceInsightsProductView

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

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

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

ช่อง
price

Price

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

suggested_price

Price

ราคาที่แนะนำล่าสุดสำหรับผลิตภัณฑ์

effectiveness

Effectiveness

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

id

string

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

ต้องระบุในอนุประโยค SELECT

offer_id

string

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

title

string

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

brand

string

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

category_l1

string

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

category_l2

string

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

category_l3

string

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

category_l4

string

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

category_l5

string

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

product_type_l1

string

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

product_type_l2

string

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

product_type_l3

string

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

product_type_l4

string

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

product_type_l5

string

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

predicted_impressions_change_fraction

double

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

predicted_clicks_change_fraction

double

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

predicted_conversions_change_fraction

double

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

ประสิทธิภาพ

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

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

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

ProductPerformanceView

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

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

ไม่สามารถเลือกช่องกลุ่มในข้อความค้นหาหากไม่เลือกช่องเมตริกอย่างน้อย 1 ช่อง

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

ช่อง
date

Date

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

ต้องมีเงื่อนไข date ในอนุประโยค WHERE

week

Date

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

conversion_value

Price

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

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

marketing_method

MarketingMethodEnum

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

customer_country_code

string

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

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

offer_id

string

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

title

string

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

brand

string

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

category_l1

string

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

category_l2

string

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

category_l3

string

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

category_l4

string

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

category_l5

string

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

product_type_l1

string

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

product_type_l2

string

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

product_type_l3

string

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

product_type_l4

string

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

product_type_l5

string

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

custom_label0

string

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

custom_label1

string

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

custom_label2

string

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

custom_label3

string

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

custom_label4

string

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

clicks

int64

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

impressions

int64

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

click_through_rate

double

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

conversions

double

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

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

conversion_rate

double

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

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

ProductView

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

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

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

ช่อง
price

Price

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

gtin[]

string

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

creation_time

Timestamp

เวลาที่ผู้ขายสร้างผลิตภัณฑ์เป็นวินาที

expiration_date

Date

วันที่หมดอายุสำหรับผลิตภัณฑ์ ที่ระบุในการแทรก

item_issues[]

ItemIssue

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

ช่องนี้ใช้จัดเรียงผลการค้นหาไม่ได้

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

click_potential

ClickPotential

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

id

string

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

ต้องระบุในอนุประโยค SELECT

channel

ChannelEnum

ช่องทางของผลิตภัณฑ์ อาจเป็น ONLINE หรือ LOCAL ก็ได้

language_code

string

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

feed_label

string

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

offer_id

string

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

title

string

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

brand

string

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

category_l1

string

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

category_l2

string

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

category_l3

string

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

category_l4

string

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

category_l5

string

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

product_type_l1

string

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

product_type_l2

string

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

product_type_l3

string

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

product_type_l4

string

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

product_type_l5

string

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

condition

string

สภาพสินค้าของผลิตภัณฑ์

availability

string

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

shipping_label

string

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

item_group_id

string

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

aggregated_reporting_context_status

AggregatedReportingContextStatus

สถานะรวม

click_potential_rank

int64

อันดับของผลิตภัณฑ์ตามโอกาสที่จะได้รับคลิก ผลิตภัณฑ์ที่มี click_potential_rank 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 ผลิตภัณฑ์มีสิทธิ์สำหรับบริบทการรายงานทั้งหมด

ClickPotential

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

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

ItemIssue

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

ช่อง
type

ItemIssueType

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

severity

ItemIssueSeverity

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

resolution

ItemIssueResolution

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

ItemIssueResolution

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

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

ItemIssueSeverity

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

ช่อง
severity_per_reporting_context[]

IssueSeverityPerReportingContext

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

aggregated_severity

AggregatedIssueSeverity

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

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

AggregatedIssueSeverity

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

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

IssueSeverityPerReportingContext

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

ช่อง
disapproved_countries[]

string

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

demoted_countries[]

string

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

reporting_context

ReportingContextEnum

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

ItemIssueType

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

ช่อง
code

string

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

canonical_attribute

string

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

RelativeDemand

ประเภทนี้ไม่มีช่อง

ความต้องการแบบสัมพัทธ์ของคลัสเตอร์ผลิตภัณฑ์หรือแบรนด์ในรายงานสินค้าขายดี

RelativeDemandEnum

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

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

RelativeDemandChangeType

ประเภทนี้ไม่มีช่อง

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

RelativeDemandChangeTypeEnum

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

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

ReportGranularity

ประเภทนี้ไม่มีช่อง

รายละเอียดของรายงานสินค้าขายดี ระบบจะคำนวณรายงานสินค้าขายดีในระยะเวลา 1 สัปดาห์และ 1 เดือน

ReportGranularityEnum

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

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

ReportRow

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

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

ช่อง
product_performance_view

ProductPerformanceView

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

non_product_performance_view

NonProductPerformanceView

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

product_view

ProductView

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

price_competitiveness_product_view

PriceCompetitivenessProductView

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

price_insights_product_view

PriceInsightsProductView

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

best_sellers_product_cluster_view

BestSellersProductClusterView

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

best_sellers_brand_view

BestSellersBrandView

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

competitive_visibility_competitor_view

CompetitiveVisibilityCompetitorView

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

competitive_visibility_top_merchant_view

CompetitiveVisibilityTopMerchantView

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

competitive_visibility_benchmark_view

CompetitiveVisibilityBenchmarkView

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

SearchRequest

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

ช่อง
parent

string

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

query

string

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

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

page_size

int32

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

page_token

string

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

SearchResponse

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

ช่อง
results[]

ReportRow

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

next_page_token

string

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

TrafficSource

ประเภทนี้ไม่มีช่อง

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

TrafficSourceEnum

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

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