- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- ผลการค้นหาประสิทธิภาพพร็อพเพอร์ตี้
- ระยะเวลาการจองล่วงหน้า
- ความยาวของการเข้าพัก
- อัตราการเข้าพัก
ทําให้ค้นหารายงาน (รับ กรอง และแบ่งกลุ่ม) รายงานประสิทธิภาพของพร็อพเพอร์ตี้สําหรับบัญชีที่เฉพาะเจาะจงได้
คำขอ HTTP
GET https://travelpartner.googleapis.com/v3/{name=accounts/*}/propertyPerformanceReportViews:query
URL ใช้ไวยากรณ์ gRPC Transcoding
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
name |
ชื่อทรัพยากรของบัญชีที่ค้นหา รูปแบบ: accounts/{account_id} |
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
filter |
เงื่อนไข (ช่องและนิพจน์) ที่ใช้เพื่อกรองเมตริกประสิทธิภาพของพร็อพเพอร์ตี้สําหรับบัญชีที่ค้นหา ไวยากรณ์ต้องใช้การเว้นวรรครอบโอเปอเรเตอร์ ต้องระบุข้อมูลในช่อง ค่าในช่อง ค่าของ ตัวอย่างของเงื่อนไขที่ถูกต้องมีดังต่อไปนี้
|
aggregateBy |
ระบุวิธีแบ่งกลุ่มเมตริกที่แสดงผลโดยการค้นหา ตัวอย่างเช่น หากมีการระบุ ค่าสตริงคือรายการช่องที่คั่นด้วยเครื่องหมายจุลภาค ช่องที่ถูกต้องคือ |
pageSize |
จํานวนผลลัพธ์การเข้าร่วมสูงสุดที่จะส่งคืน บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ระบุ ระบบจะแสดงผลมากที่สุด 10,000 รายการ ค่าสูงสุดคือ 10,000 รายการ ค่าที่สูงกว่า 10,000 จะถูกเปลี่ยนเป็น 10,000 |
pageToken |
โทเค็นหน้าเว็บที่ได้รับจากคําขอ engagementReportViews.query ก่อนหน้านี้ ระบุข้อมูลนี้เพื่อรับหน้าต่อไป เมื่อมีการใส่เลขหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ส่งถึง engagementReportViews.query จะต้องตรงกับการเรียกใช้โทเค็นของหน้าเว็บ |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
ข้อความตอบกลับสําหรับ PropertyPerformanceReportService.QueryPropertyPerformanceReport
การแสดง JSON |
---|
{
"results": [
{
object ( |
ช่อง | |
---|---|
results[] |
รายการผลการค้นหาที่ตรงกับคําค้นหา |
nextPageToken |
โทเค็นการใส่เลขหน้าที่ใช้สําหรับเรียกหน้าถัดไปของผลลัพธ์ หากไม่ระบุช่องนี้ จะไม่มีหน้าต่อๆ ไป |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/travelpartner
โปรดดูข้อมูลเพิ่มเติมที่หัวข้อภาพรวมของ OAuth 2.0
ผลการค้นหาประสิทธิภาพพร็อพเพอร์ตี้
แสดงถึงผลลัพธ์จากการค้นหารายงานประสิทธิภาพของพร็อพเพอร์ตี้สําหรับบัญชี
การแสดง JSON |
---|
{ "date": { object ( |
ช่อง | |
---|---|
date |
วันที่ภายในช่วงวันที่ที่ขอ แสดงเฉพาะเมื่อระบุ |
advanceBookingWindow |
ความแตกต่างของจํานวนวันระหว่างวันที่สืบค้นกับวันที่เช็คอินในเขตเวลาท้องถิ่นของที่พัก แสดงเฉพาะเมื่อระบุ |
brand |
แบรนด์ที่พาร์ทเนอร์ระบุไว้สําหรับที่พัก แสดงเฉพาะเมื่อระบุ |
deviceType |
ประเภทอุปกรณ์ของผู้ใช้ แสดงเฉพาะเมื่อระบุ |
highIntentUsers |
คําค้นหาของผู้ใช้บ่งชี้ว่ามีความสนใจในการจองอย่างมากหรือไม่ แสดงเฉพาะเมื่อระบุ |
lengthOfStay |
จํานวนคืนระหว่างวันที่เช็คอินและเช็คเอาต์ที่ระบุโดยผู้ใช้ แสดงเฉพาะเมื่อระบุ |
propertyRegionCode |
รหัสภูมิภาค ISO 3116 ของประเทศ/ภูมิภาคของที่พัก แสดงเฉพาะเมื่อระบุ |
occupancy |
จํานวนผู้คนที่ขอเข้าพักในที่พัก แสดงเฉพาะเมื่อระบุ |
partnerPropertyId |
รหัสพร็อพเพอร์ตี้ของพาร์ทเนอร์ แสดงเฉพาะเมื่อระบุ |
partnerPropertyDisplayName |
ชื่อพร็อพเพอร์ตี้ของพาร์ทเนอร์ แสดงเฉพาะเมื่อระบุ |
userRegionCode |
รหัสภูมิภาค ISO 3116 ของประเทศ/ภูมิภาคของผู้ใช้ แสดงเฉพาะเมื่อระบุ |
clickCount |
จํานวนคลิกทั้งหมดที่บันทึกไว้สําหรับผลลัพธ์นี้ |
impressionCount |
จํานวนการแสดงผลที่บันทึกไว้ทั้งหมดสําหรับผลการค้นหานี้ โดยระบบจะปัดเศษค่านี้เพื่อรักษาความเป็นส่วนตัวของผู้ใช้ |
clickthroughRate |
เท่ากับ |
ระยะเวลาการจองล่วงหน้า
แจกแจงกรอบเวลาการจองล่วงหน้าที่รองรับ (ABW) การเปรียบเทียบวันที่ทั้งหมดอยู่ในเขตเวลาของพร็อพเพอร์ตี้
Enum | |
---|---|
ADVANCE_BOOKING_WINDOW_UNSPECIFIED |
ไม่ได้ระบุ |
ADVANCE_BOOKING_WINDOW_SAME_DAY |
วันที่เช็คอินเป็นวันเดียวกับวันที่สืบค้น |
ADVANCE_BOOKING_WINDOW_NEXT_DAY |
วันที่เช็คอินคือวันถัดไปหลังจากวันที่ค้นหา |
ADVANCE_BOOKING_WINDOW_DAYS_2_TO_7 |
วันที่เช็คอินคือ 2-7 วันหลังจากวันที่สืบค้น |
ADVANCE_BOOKING_WINDOW_DAYS_8_TO_14 |
วันที่เช็คอินคือ 8-14 วันหลังจากวันที่สืบค้น |
ADVANCE_BOOKING_WINDOW_DAYS_15_TO_30 |
วันที่เช็คอินคือ 15-30 วันหลังจากวันที่สืบค้น |
ADVANCE_BOOKING_WINDOW_DAYS_31_TO_60 |
วันที่เช็คอินคือ 31-60 วันหลังจากวันที่สืบค้น |
ADVANCE_BOOKING_WINDOW_DAYS_61_TO_90 |
วันที่เช็คอินคือ 61-90 วันหลังจากวันที่สืบค้น |
ADVANCE_BOOKING_WINDOW_DAYS_91_TO_120 |
วันที่เช็คอินคือ 91-120 วันหลังจากวันที่สืบค้น |
ADVANCE_BOOKING_WINDOW_DAYS_121_TO_150 |
วันที่เช็คอินคือ 121-150 วันหลังจากวันที่สืบค้น |
ADVANCE_BOOKING_WINDOW_DAYS_151_TO_180 |
วันที่เช็คอินคือ 151-180 วันหลังจากวันที่สืบค้น |
ADVANCE_BOOKING_WINDOW_DAYS_OVER_180 |
วันที่เช็คอินเกิน 180 วันหลังจากวันที่ค้นหา |
ระยะเวลาในการเข้าพัก
ระบุระยะเวลาเข้าพักที่รองรับ (LOS)
Enum | |
---|---|
LENGTH_OF_STAY_UNSPECIFIED |
ไม่ได้ระบุ |
LENGTH_OF_STAY_NIGHTS_1 |
การเข้าพัก 1 คืน |
LENGTH_OF_STAY_NIGHTS_2 |
การเข้าพัก 2 คืน |
LENGTH_OF_STAY_NIGHTS_3 |
การเข้าพัก 3 คืน |
LENGTH_OF_STAY_NIGHTS_4_TO_7 |
การเข้าพัก 4-7 คืน |
LENGTH_OF_STAY_NIGHTS_8_TO_14 |
การเข้าพัก 8-14 คืน |
LENGTH_OF_STAY_NIGHTS_15_TO_21 |
การเข้าพัก 15-21 คืน |
LENGTH_OF_STAY_NIGHTS_22_TO_30 |
การเข้าพัก 22-30 คืน |
LENGTH_OF_STAY_NIGHTS_OVER_30 |
การเข้าพักมากกว่า 30 คืน |
การเข้าพัก
แจกแจงจํานวนผู้เข้าพักทั้งหมดของห้องที่รองรับ
Enum | |
---|---|
OCCUPANCY_UNSPECIFIED |
ไม่ได้ระบุ |
OCCUPANCY_1 |
คนเดียว |
OCCUPANCY_2 |
2 คน |
OCCUPANCY_3 |
3 คน |
OCCUPANCY_4 |
4 คน |
OCCUPANCY_OVER_4 |
มากกว่า 4 คน |