Method: accounts.freeBookingLinksReportViews.query

DESTEĞİ SONLANDIRILDI: Bunun yerine gösterim raporlaması da içeren PropertyPerformanceReportService.QueryPropertyPerformanceReport özelliğini kullanın. Belirli bir hesap için ücretsiz rezervasyon bağlantıları raporunu sorgulama (alma, filtreleme ve segmentlere ayırma) olanağı sağlar.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

Sorgulanan hesabın kaynak adı. Biçim: accounts/{account_id}

Sorgu parametreleri

Parametreler
filter

string

Sorgulanan hesap için ücretsiz rezervasyon bağlantısı metriklerini filtrelemek üzere kullanılan koşullar (alanlar ve ifadeler). Söz diziminde in operatörünün etrafında boşluk olması gerekir. Aksi takdirde boşluklar atlanabilir. Koşullar and operatörü kullanılarak birleştirilebilir.

date alanı zorunludur. Diğer tüm alanlar isteğe bağlıdır.

date alan değerleri dahilidir ve YYYY-AA-GG biçiminde olmalıdır. Kabul edilebilir en erken tarih 2021-03-09'dur. Daha önceki tarih değerleri 2021-03-09 olarak zorlanır.

partnerHotelDisplayName değerleri büyük/küçük harfe duyarlı olmadan eşleştirilir.

Geçerli koşullara örnek olarak aşağıdakiler verilebilir:

  • 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

Sorgu tarafından döndürülen metriklerin nasıl bölümlendirileceğini belirtir. Örneğin, userRegionCode belirtilirse freeBookingLinksResult, kullanıcı bölgesine göre toplanan metrikleri sağlar.

Dize değeri, virgülle ayrılmış bir alan listesidir. Geçerli alanlar: date, userRegionCode, deviceType, partnerHotelId ve partnerHotelDisplayName. FreeBookingLinksResult'a yalnızca burada belirtilen alanlar dahil edilir.
pageSize

integer

Döndürülecek maksimum katılım sonucu sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmezse en fazla 10.000 sonuç döndürülür. Maksimum değer 10.000'dir. 10.000'in üzerindeki değerler 10.000'e zorlanır.
pageToken

string

Önceki bir participationReportViews.query isteğinden alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalara ayırma işlemi yapılırken participationReportViews.query'ye sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

DESTEĞİ SONLANDIRILDI: Bunun yerine PropertyPerformanceReportService ile QueryPropertyPerformanceReportResponse kullanın. FreeBookingLinksReportService.QueryFreeBookingLinksReport için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "results": [
    {
      object (FreeBookingLinksResult)
    }
  ],
  "nextPageToken": string
}
Alanlar
results[]

object (FreeBookingLinksResult)

Sorguyla eşleşen sonuçların listesi.
nextPageToken

string

Sonuçların sonraki sayfasını almak için kullanılan sayfalama jetonu. Bu alan atlanırsa sonraki sayfa yoktur.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.

FreeBookingLinksResult

DESTEĞİ SONLANDIRILDI: Bunun yerine PropertyPerformanceReportService ile PropertyPerformanceResult kullanın. Bir hesap için ücretsiz rezervasyon bağlantısı istatistikleri sorgulama sonucunu temsil eder.

JSON gösterimi 
{
  "date": {
    object (Date)
  },
  "userRegionCode": string,
  "deviceType": enum (Device),
  "partnerHotelId": string,
  "partnerHotelDisplayName": string,
  "clickCount": string
}
Alanlar
date

object (Date)

İstenen tarih aralığında bir tarih.

Yalnızca istekteki aggregateBy içinde date belirtilmişse bulunur.
userRegionCode

string

Kullanıcının bulunduğu ülkenin/bölgenin ISO 3116 bölge kodu.

Yalnızca istekte aggregateBy içinde userRegionCode belirtilmişse bulunur.
deviceType

enum (Device)

Kullanıcının cihaz türü.

Yalnızca istekteki aggregateBy içinde deviceType belirtilmişse bulunur.
partnerHotelId

string

İş ortağının otel kimliği.

Yalnızca istekteki aggregateBy içinde partnerHotelId belirtilmişse bulunur.
partnerHotelDisplayName

string

İş ortağının otel adı.

Yalnızca istekteki aggregateBy içinde partnerHotelDisplayName belirtilmişse bulunur.
clickCount

string (int64 format)

Bu sonuç için kaydedilen toplam tıklama sayısı.