Method: accounts.participationReportViews.query

ทําให้ค้นหา (รับ กรอง และแบ่งกลุ่ม) รายงานการเข้าร่วมสําหรับบัญชีหนึ่งๆ ได้

คำขอ HTTP

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

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

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

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

string

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

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

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

string

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

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

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

  • advanceBookingWindow = 2
  • advanceBookingWindow >= 0
  • advanceBookingWindow <= 5
  • advanceBookingWindow between 1 and 5
  • checkinDate = '2020-10-01'
  • checkinDate >= '2020-10-01'
  • checkinDate <= '2020-10-01'
  • checkinDate between '2020-10-01' and '2020-10-05'
  • date = '2020-02-04'
  • date between '2020-02-04' and '2020-02-09'
  • deviceType = 'TABLET'
  • deviceType in ('MOBILE', 'TABLET')
  • hotelRegionCode = 'US'
  • hotelRegionCode in ('US', 'CA')
  • lengthOfStayDays = 2
  • lengthOfStayDays >= 0
  • lengthOfStayDays <= 5
  • lengthOfStayDays between 1 and 5
  • occupancy = 2
  • occupancy >= 0
  • occupancy <= 5
  • occupancy between 1 and 5
  • partnerHotelId = 'AAA'
  • partnerHotelId in ('AAA', 'BBB')
  • userRegionCode = 'US'
  • userRegionCode in ('US', 'CA')
aggregateBy

string

ระบุวิธีแบ่งกลุ่มเมตริกที่แสดงผลโดยการค้นหา เช่น หากมีการระบุ userRegionCode เป็นค่า aggregateBy participationResult จะแสดงเมตริกที่รวบรวมตามภูมิภาคผู้ใช้

ค่าสตริงคือรายการช่องที่คั่นด้วยเครื่องหมายจุลภาค ช่องที่ถูกต้องคือ date, userRegionCode, deviceType, partnerHotelId, hotelRegionCode, advanceBookingWindow, lengthOfStayDays, checkinDate และ occupancy ช่องที่ไม่ได้ระบุไว้จะไม่รวมอยู่ใน ParticipationResult

การใช้ข้อกําหนด aggregateBy ที่สร้างแถวจํานวนมากจะทําให้เกิดข้อผิดพลาด โดยเฉพาะอย่างยิ่งเมื่อรวม partnerHotelId หรือมากกว่า 2 ช่อง หากต้องการลดโอกาสที่จะเกิดข้อผิดพลาด ให้กรองตาม partnerHotelId และ date เพื่อระบุโรงแรมและวันที่ที่เลือกเท่านั้น บัญชีที่มีโรงแรมจํานวนมากจะต้องลดจํานวนข้อมูลลงเมื่อกรองได้มากขึ้น
pageSize

integer

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

string

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

เมื่อมีการใส่เลขหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ส่งถึง engagementReportViews.query จะต้องตรงกับการเรียกใช้โทเค็นของหน้าเว็บ

เนื้อหาของคำขอ

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

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

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

ข้อความตอบกลับสําหรับ ParticipationReportService.QueryParticipationReport

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

object (ParticipationResult)

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

string

โทเค็นการใส่เลขหน้าที่ใช้สําหรับเรียกหน้าถัดไปของผลลัพธ์

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

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

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

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

ผลการเข้าร่วม

แสดงถึงผลลัพธ์จากการค้นหาสถิติการเข้าร่วมของบัญชี

การแสดง JSON 
{
  "key": {
    object (Key)
  },
  "opportunityCount": string,
  "participationCount": string,
  "participationPercent": number,
  "missedParticipationCount": string,
  "missedParticipationCountDetails": {
    object (MissedParticipationCountDetails)
  },
  "partnerHotelDisplayName": string
}
ช่อง
key

object (Key)

คีย์ของผลลัพธ์
opportunityCount

string (int64 format)

จํานวนโอกาสทั้งหมดที่มีสําหรับโรงแรมหนึ่งๆ โอกาสคือจํานวนครั้งทั้งหมดที่โฆษณาโรงแรมแสดงต่อผู้ใช้ได้
participationCount

string (int64 format)

จํานวนโอกาสทั้งหมดที่คุณมีสิทธิ์เข้าร่วมกระบวนการประมูลของ Google Ads
participationPercent

number

อัตราเปอร์เซ็นต์การเข้าร่วมที่จํานวนโอกาสที่เข้าร่วมสําเร็จหารด้วยจํานวนโอกาสทั้งหมด ตัวอย่างเช่น หากที่พักมีสิทธิ์เข้าร่วมการประมูลของ Google Ads 90 ครั้งจากโอกาส 100 ครั้ง อัตราการเข้าร่วมคือ 90%
missedParticipationCount

string (int64 format)

จํานวนโอกาสทั้งหมดที่ไม่มีสิทธิ์เข้าร่วมกระบวนการประมูลของ Google Ads โดยจะประกอบด้วยรายการต่อไปนี้

  • ไม่มีหน้า Landing Page
  • ราคาขาดหายไป
  • ปัญหาเกี่ยวกับราคา
  • ไม่มีข้อมูลราคา
  • อื่นๆ
missedParticipationCountDetails

object (MissedParticipationCountDetails)

สาเหตุที่ทําให้เกิดจํานวนการเข้าร่วมที่คุณพลาด (เช่น ไม่มีห้องว่าง) และจํานวนรวมของเหตุผลแต่ละข้อ
partnerHotelDisplayName

string

ชื่อที่แสดงของโรงแรมของพาร์ทเนอร์ ช่องนี้จะมีข้อมูลเฉพาะเมื่อผลลัพธ์รวบรวมโดย partnerHotelId

คีย์

คีย์ของผลลัพธ์

การแสดง JSON 
{
  "date": {
    object (Date)
  },
  "userRegionCode": string,
  "deviceType": enum (Device),
  "partnerHotelId": string,
  "hotelRegionCode": string,
  "advanceBookingWindow": integer,
  "lengthOfStayDays": integer,
  "checkinDate": {
    object (Date)
  },
  "occupancy": integer
}
ช่อง
date

object (Date)

วันที่ที่คุณต้องการขอเมตริก

หาก date ไม่ใช่ค่าของพารามิเตอร์ aggregateBy ในการเรียกใช้คําขอ ช่อง date จะไม่แสดงผลใน Key
userRegionCode

string

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

หาก userRegionCode ไม่ใช่ค่าของพารามิเตอร์ aggregateBy ในการเรียกใช้คําขอ ช่อง userRegionCode จะไม่แสดงผลใน Key
deviceType

enum (Device)

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

หาก deviceType ไม่ใช่ค่าของพารามิเตอร์ aggregateBy ในการเรียกใช้คําขอ ช่อง deviceType จะไม่แสดงผลใน Key
partnerHotelId

string

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

หาก partnerHotelId ไม่ใช่ค่าของพารามิเตอร์ aggregateBy ในการเรียกใช้คําขอ ช่อง partnerHotelId จะไม่แสดงผลใน Key
hotelRegionCode

string

รหัสภูมิภาคของ CLDR ของประเทศ/ภูมิภาคของโรงแรม

หาก hotelRegionCode ไม่ใช่ค่าของพารามิเตอร์ aggregateBy ในการเรียกใช้คําขอ ช่อง hotelRegionCode จะไม่แสดงผลใน Key
advanceBookingWindow

integer

จํานวนวันล่วงหน้าที่ผู้ใช้ต้องการจองแผนการเดินทาง

หาก advanceBookingWindow ไม่ใช่ค่าของพารามิเตอร์ aggregateBy ในการเรียกใช้คําขอ ช่อง advanceBookingWindow จะไม่แสดงผลใน Key
lengthOfStayDays

integer

จํานวนคืนสําหรับแผนการเดินทาง

หาก lengthOfStayDays ไม่ใช่ค่าของพารามิเตอร์ aggregateBy ในการเรียกใช้คําขอ ช่อง lengthOfStayDays จะไม่แสดงผลใน Key
checkinDate

object (Date)

วันที่เช็คอินของแผนการเดินทาง

หาก checkinDate ไม่ใช่ค่าของพารามิเตอร์ aggregateBy ในการเรียกใช้คําขอ ช่อง checkinDate จะไม่แสดงผลใน Key
occupancy

integer

อัตราการเข้าพักทั้งหมดของแผนการเดินทาง

หาก occupancy ไม่ใช่ค่าของพารามิเตอร์ aggregateBy ในการเรียกใช้คําขอ ช่อง occupancy จะไม่แสดงผลใน Key

รายละเอียดจํานวนการเข้าร่วมที่คุณพลาด

จํานวนการเข้าร่วมที่คุณพลาดแยกตามเหตุผล

การแสดง JSON 
{
  "noAvailabilityCount": string,
  "hotelSuspendedCount": string,
  "noTaxBreakdownCount": string,
  "noLandingPageCount": string,
  "noPriceCount": string,
  "noPriceCountDetails": {
    object (NoPriceCountDetails)
  },
  "otherReasonCount": string,
  "priceMissingCount": string,
  "priceMissingCountDetails": {
    object (PriceMissingCountDetails)
  },
  "priceProblemCount": string,
  "priceProblemCountDetails": {
    object (PriceProblemCountDetails)
  },
  "priceUnavailableCount": string,
  "priceUnavailableCountDetails": {
    object (PriceUnavailableCountDetails)
  }
}
ช่อง
noAvailabilityCount
(deprecated)

string (int64 format)

จํานวนการเข้าร่วมที่คุณพลาดทั้งหมดเนื่องจากชุดค่าผสมของโรงแรม/แผนการเดินทางไม่พร้อมให้บริการ หรือผู้เดินทางไม่มีสิทธิ์สําหรับราคานี้ คุณอาจต้องระบุข้อมูลราคาเพิ่มเติมจึงจะเข้าร่วมการประมูลเหล่านี้ได้
hotelSuspendedCount
(deprecated)

string (int64 format)

จํานวนการเข้าร่วมที่คุณพลาดทั้งหมดเนื่องจากโรงแรมอย่างน้อย 1 แห่งของคุณถูกระงับเนื่องจากการละเมิดความถูกต้องของราคา
noTaxBreakdownCount
(deprecated)

string (int64 format)

จํานวนการเข้าร่วมที่คุณพลาดทั้งหมดเนื่องจากโรงแรมอย่างน้อย 1 แห่งของคุณไม่ได้ระบุภาษีและค่าธรรมเนียมแยกกัน
noLandingPageCount

string (int64 format)

ไม่มีหน้า Landing Page ที่ตรงกับผู้ใช้
noPriceCount
(deprecated)

string (int64 format)

จํานวนการเข้าร่วมที่คุณพลาดทั้งหมดเนื่องจากไม่มีราคาสําหรับแผนการเดินทางที่ขอ
noPriceCountDetails
(deprecated)

object (NoPriceCountDetails)

สาเหตุที่ทําให้จํานวนราคาไม่ได้ (เช่น ไม่มีราคาแบบเรียลไทม์) และจํานวนทั้งหมดของแต่ละเหตุผล
otherReasonCount

string (int64 format)

โรงแรมไม่ได้เข้าร่วมโดยไม่ทราบเหตุผล
priceMissingCount

string (int64 format)

จํานวนการเข้าร่วมที่คุณพลาดทั้งหมดเนื่องจากราคาไม่แสดงในแคชของ Google หรือตอบสนองต่อราคาแบบเรียลไทม์ไม่สําเร็จ โดยจะประกอบด้วยรายการต่อไปนี้

  • แบนด์วิดท์หมด
  • ไม่มีอัตราแคช
  • แผนการเดินทางถูกบล็อก
  • ไม่ได้ตั้งค่าราคาแบบเรียลไทม์
  • ราคาแบบเรียลไทม์หมดเวลาแล้ว
  • ข้อผิดพลาดด้านราคาแบบเรียลไทม์
priceMissingCountDetails

object (PriceMissingCountDetails)

สาเหตุที่จํานวนราคาลดลง
priceProblemCount

string (int64 format)

จํานวนการเข้าร่วมที่คุณพลาดทั้งหมดเนื่องจากปัญหาเกี่ยวกับความถูกต้องของราคาที่ระบุไว้สําหรับแผนการเดินทาง โดยจะประกอบด้วยรายการต่อไปนี้

  • โรงแรมถูกระงับ
  • ราคาสูงกว่าปกติ
  • ราคาต่ํากว่าปกติ
  • ไม่มีภาษีและฟีด
priceProblemCountDetails

object (PriceProblemCountDetails)

สาเหตุที่ทําให้จํานวนราคาลดลง
priceUnavailableCount

string (int64 format)

จํานวนการเข้าร่วมที่คุณพลาดทั้งหมดเนื่องจากมีการระบุว่าราคาไม่พร้อมใช้งาน (-1) สําหรับแผนการเดินทางที่ขอ โดยจะประกอบด้วยรายการต่อไปนี้

  • ไม่มีข้อมูลราคา
  • ไม่มีแนวโน้มที่จะเข้าร่วม
  • อื่นๆ
priceUnavailableCountDetails

object (PriceUnavailableCountDetails)

สาเหตุที่ทําให้ราคาไม่พร้อมใช้งาน

รายละเอียดจํานวนราคา

สาเหตุของการไม่มีจํานวนราคาและจํานวนทั้งหมดของเหตุผลแต่ละข้อ

การแสดง JSON 
{
  "livePricingTechnicalIssueCount": string,
  "livePricingNotTriggeredCount": string,
  "livePricingConfigIssueCount": string,
  "livePricingNotAvailableCount": string,
  "livePricingOtherReasonCount": string
}
ช่อง
livePricingTechnicalIssueCount

string (int64 format)

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

  • คุณตอบกลับช้าเกินไปและเกินกําหนดเวลาตอบกลับ (ประมาณ 4,000 มิลลิวินาที)
  • คุณแสดงผลข้อผิดพลาด
  • รูปแบบการตอบกลับไม่ถูกต้อง
livePricingNotTriggeredCount

string (int64 format)

จํานวนการเข้าร่วมที่คุณพลาดทั้งหมดเนื่องจากระบบไม่เรียกให้แสดงราคาแบบเรียลไทม์ ซึ่งเกิดจากสาเหตุใดสาเหตุหนึ่งต่อไปนี้

  • คุณไม่ได้กําหนดราคาเสนอ
  • คุณไม่มีหน้า Landing Page ที่ถูกต้อง
  • มีราคาไม่เพียงพอในแคช
livePricingConfigIssueCount

string (int64 format)

จํานวนการเข้าร่วมที่คุณพลาดทั้งหมดเนื่องจากระบบไม่เรียกให้แสดงราคาแบบเรียลไทม์ ซึ่งเกิดจากสาเหตุใดสาเหตุหนึ่งต่อไปนี้

  • คุณไม่ได้กําหนดค่าราคาแบบเรียลไทม์สําหรับการค้นหาเหล่านี้
  • คุณจํากัดไม่ให้ Google เข้าถึงแผนการจองโรงแรมที่เป็นปัญหา
livePricingNotAvailableCount

string (int64 format)

จํานวนการเข้าร่วมที่คุณพลาดทั้งหมดเนื่องจากราคาแบบเรียลไทม์ไม่พร้อมใช้งาน ระบบจะไม่เรียกให้แสดงราคาแบบเรียลไทม์สําหรับ UI หรือแผนการเดินทางเริ่มต้นบางรายการ ในกรณีนี้ พาร์ทเนอร์จะต้องมีราคาที่แคชจึงจะเข้าร่วมได้
livePricingOtherReasonCount

string (int64 format)

จํานวนการเข้าร่วมที่คุณพลาดเนื่องจากปัญหาอื่นๆ เกี่ยวกับราคาแบบเรียลไทม์

รายละเอียดจํานวนราคาขาดหายไป

สาเหตุที่จํานวนราคาขาดหายไปและจํานวนทั้งหมดของแต่ละเหตุผล

การแสดง JSON 
{
  "cacheRateMissingCount": string,
  "itineraryBlockedCount": string,
  "livePricingNotSetupCount": string,
  "bandwidthDepletedCount": string,
  "livePricingTimeoutCount": string,
  "livePricingErrorCount": string
}
ช่อง
cacheRateMissingCount

string (int64 format)

ไม่มีราคาในแคชสําหรับแผนการเดินทางนี้ การค้นหาแบบเรียลไทม์ยังไม่เสร็จสมบูรณ์เนื่องจากข้อจํากัดของหน้า
itineraryBlockedCount

string (int64 format)

แผนการเดินทางอยู่นอกพารามิเตอร์พื้นฐาน ระบบจึงดึงข้อมูลราคาสําหรับแผนการเดินทางจากการค้นหาแบบเรียลไทม์หรือการเติมแคชไม่ได้
livePricingNotSetupCount

string (int64 format)

ไม่มีการแคชราคาสําหรับแผนการเดินทางนี้ และไม่มีการกําหนดค่าการค้นหาแบบเรียลไทม์สําหรับบัญชีนี้
bandwidthDepletedCount

string (int64 format)

ไม่มีการแคชราคาสําหรับแผนการเดินทางนี้ และโควต้าการค้นหาแบบเรียลไทม์หมดแล้ว
livePricingTimeoutCount

string (int64 format)

ไม่มีการแคชราคาสําหรับแผนการเดินทางนี้ และการค้นหาแบบเรียลไทม์ที่ส่งไปยังระบบของคุณหมดเวลาแล้ว
livePricingErrorCount

string (int64 format)

ไม่มีการแคชราคาสําหรับแผนการเดินทางนี้ การค้นหาแบบเรียลไทม์ยังไม่หมดเวลา แต่ระบบแสดงข้อผิดพลาด

รายละเอียดจํานวนปัญหาราคา

สาเหตุที่ทําให้จํานวนปัญหาราคาและจํานวนทั้งหมดของแต่ละสาเหตุ

การแสดง JSON 
{
  "hotelSuspendedCount": string,
  "priceUnusuallyHighCount": string,
  "priceUnusuallyLowCount": string,
  "taxesAndFeesMissingCount": string
}
ช่อง
hotelSuspendedCount

string (int64 format)

โรงแรมถูกระงับ ซึ่งอาจเกิดจากปัญหาต่างๆ ที่เกิดขึ้นอย่างต่อเนื่อง เช่น ภาษีและค่าธรรมเนียมไม่ถูกต้อง
priceUnusuallyHighCount

string (int64 format)

ดูเหมือนว่าราคาที่ระบุสําหรับแผนการเดินทางนี้จะสูงกว่าปกติเมื่อเทียบกับแนวโน้มระดับภูมิภาค
priceUnusuallyLowCount

string (int64 format)

ดูเหมือนว่าราคาที่ระบุสําหรับแผนการเดินทางนี้จะต่ํากว่าปกติเมื่อเทียบกับแนวโน้มระดับภูมิภาค
taxesAndFeesMissingCount

string (int64 format)

ภาษีและค่าธรรมเนียมไม่ได้รวมอยู่ในราคา

รายละเอียดจํานวนราคาที่ไม่พร้อมใช้งาน

สาเหตุที่ทําให้จํานวนราคาไม่พร้อมใช้งานและจํานวนทั้งหมดของแต่ละเหตุผล

การแสดง JSON 
{
  "priceUnavailableCount": string,
  "participationNotLikelyCount": string
}
ช่อง
priceUnavailableCount

string (int64 format)

โรงแรมไม่ได้เข้าร่วมเนื่องจากไม่มีห้องว่างในวันที่ระบุในแผนการเดินทาง
participationNotLikelyCount

string (int64 format)

ไม่มีการแคชราคาสําหรับแผนการเดินทางนี้ และไม่มีการค้นหาแบบเรียลไทม์เนื่องจากเซิร์ฟเวอร์ของคุณมักแจ้งเราว่าโรงแรมไม่มีห้องว่างหรือเต็มแล้ว