Method: accounts.freeBookingLinksReportViews.query

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

คำขอ HTTP

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

URL ใช้ไวยากรณ์ gRPC Transcoding

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

พารามิเตอร์
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

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

เมื่อมีการใส่เลขหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ส่งถึง engagementReportViews.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

ผลลัพธ์ของลิงก์การจองแบบไม่เสียค่าใช้จ่าย

เลิกใช้งานแล้ว: ใช้ 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)

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