Method: accounts.freeBookingLinksReportViews.query

เลิกใช้งานแล้ว: ใช้ PropertyPerformanceReportService.QueryPropertyPerformanceReport แทน ซึ่งมีการรายงานการแสดงผลด้วย ช่วยให้สามารถค้นหา (รับ กรอง และแบ่งกลุ่ม) รายงานลิงก์การจองแบบไม่เสียค่าใช้จ่ายสำหรับบัญชีที่เฉพาะเจาะจง

คำขอ HTTP

GET https://travelpartner.googleapis.com/v3/{name=accounts/*}/freeBookingLinksReportViews:query

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

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

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

string

ชื่อทรัพยากรของบัญชีที่กำลังค้นหา รูปแบบ: accounts/{account_id}

พารามิเตอร์การค้นหา

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

string

เงื่อนไข (ฟิลด์และนิพจน์) ที่ใช้ในการกรองเมตริกลิงก์การจองแบบไม่เสียค่าใช้จ่ายสำหรับบัญชีที่กำลังค้นหา ไวยากรณ์ต้องมีช่องว่างรอบๆ ตัวดำเนินการ in หรือจะเว้นวรรคก็ได้ คุณสามารถรวมเงื่อนไขโดยใช้โอเปอเรเตอร์ and

ต้องระบุข้อมูลในช่อง date ช่องอื่นๆ ทั้งหมดเป็นช่องที่ไม่บังคับ

ค่าฟิลด์ date จะรวมค่าเริ่มต้นและต้องอยู่ในรูปแบบ YYYY-MM-DD วันที่ที่ยอมรับได้เร็วที่สุดคือ 2021-03-09 ค่าวันที่ก่อนหน้านี้จะถูกบังคับให้เป็น 2021-03-09

ระบบจะจับคู่ค่าสำหรับ partnerHotelDisplayName โดยไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

ตัวอย่างเงื่อนไขที่ถูกต้องมีดังนี้

  • date = '2021-12-03'
  • date between '2021-12-03' and '2021-12-08'
  • deviceType = 'TABLET'
  • deviceType in ('MOBILE', 'TABLET')
  • partnerHotelId = 'AAA'
  • partnerHotelId in ('AAA', 'BBB')
  • partnerHotelDisplayName = 'hotel A'
  • partnerHotelDisplayName in ('Hotel A', 'HOTEL b')
  • userRegionCode = 'US'
  • userRegionCode in ('US', 'CA')
aggregateBy

string

ระบุวิธีแบ่งกลุ่มเมตริกที่การค้นหาแสดงผล เช่น หากระบุ userRegionCode freeBookingLinksResult จะแสดงเมตริกที่รวบรวมตามภูมิภาคของผู้ใช้

ค่าสตริงคือรายการฟิลด์ที่คั่นด้วยคอมมา ฟิลด์ที่ถูกต้องคือ date, userRegionCode, deviceType, partnerHotelId และ partnerHotelDisplayName เฉพาะฟิลด์ที่ระบุไว้ที่นี่เท่านั้นที่จะรวมอยู่ใน FreeBookingLinksResult
pageSize

integer

จำนวนผลลัพธ์การเข้าร่วมสูงสุดที่จะแสดง บริการอาจแสดงผลน้อยกว่าค่านี้ หากไม่ระบุ ระบบจะแสดงผลลัพธ์สูงสุด 10,000 รายการ ค่าสูงสุดคือ 10,000 ค่าที่สูงกว่า 10,000 จะถูกบังคับให้เป็น 10,000
pageToken

string

โทเค็นหน้าเว็บที่ได้รับจากคำขอ participationReportViews.query ก่อนหน้า ระบุข้อมูลนี้เพื่อรับหน้าถัดไป

เมื่อแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุให้กับ participationReportViews.query ต้องตรงกับการเรียกที่ระบุโทเค็นหน้า

เนื้อความของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

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

เลิกใช้งานแล้ว: ใช้ QueryPropertyPerformanceReportResponse กับ PropertyPerformanceReportService แทน ข้อความตอบกลับสำหรับ FreeBookingLinksReportService.QueryFreeBookingLinksReport

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

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

object (FreeBookingLinksResult)

รายการผลลัพธ์ที่ตรงกับคำค้นหา
nextPageToken

string

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

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

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

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

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview

FreeBookingLinksResult

เลิกใช้งานแล้ว: ใช้ PropertyPerformanceResult กับ PropertyPerformanceReportService แทน แสดงผลลัพธ์จากการค้นหาสถิติลิงก์การจองแบบไม่เสียค่าใช้จ่ายสำหรับบัญชี

การแสดง JSON 
{
  "date": {
    object (Date)
  },
  "userRegionCode": string,
  "deviceType": enum (Device),
  "partnerHotelId": string,
  "partnerHotelDisplayName": string,
  "clickCount": string
}
ช่อง
date

object (Date)

วันที่ภายในช่วงวันที่ที่ขอ

จะแสดงก็ต่อเมื่อมีการระบุ date ใน aggregateBy ในคำขอ
userRegionCode

string

รหัสภูมิภาค ISO 3116 ของประเทศ/ภูมิภาคของผู้ใช้

จะแสดงก็ต่อเมื่อมีการระบุ userRegionCode ใน aggregateBy ในคำขอ
deviceType

enum (Device)

ประเภทอุปกรณ์ของผู้ใช้

จะแสดงก็ต่อเมื่อมีการระบุ deviceType ใน aggregateBy ในคำขอ
partnerHotelId

string

รหัสโรงแรมของพาร์ทเนอร์

จะแสดงก็ต่อเมื่อมีการระบุ partnerHotelId ใน aggregateBy ในคำขอ
partnerHotelDisplayName

string

ชื่อโรงแรมของพาร์ทเนอร์

จะแสดงก็ต่อเมื่อมีการระบุ partnerHotelDisplayName ใน aggregateBy ในคำขอ
clickCount

string (int64 format)

จำนวนคลิกทั้งหมดที่บันทึกไว้สำหรับผลลัพธ์นี้