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

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

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 สถานะ
อนุมัติแล้ว อนุมัติแล้ว มีสิทธิ์
อนุมัติแล้ว รอดำเนินการ มีสิทธิ์
อนุมัติแล้ว ไม่อนุมัติ 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

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

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 การเข้าชมจากการค้นหาทั่วไปและการเข้าชมจากโฆษณา