Method: accounts.freeBookingLinksReportViews.query

KULLANIMDAN KALDIRILDI: Bunun yerine gösterim raporu da bulunan 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, gTB Kod Geçişi söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

Sorgulanan hesabın kaynak adı. Biçim: hesaplar/{hesap_kimliği}

Sorgu parametreleri

Parametreler
filter

string

Sorgulanan hesabın ücretsiz rezervasyon bağlantısı metriklerini filtrelemek için kullanılan koşullar (alanlar ve ifadeler). Söz dizimi için in operatörünün etrafında boşluklar eklenmesi 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 kapsayıcıdır ve YYYY-AA-GG biçiminde olmalıdır. Kabul edilebilir en erken tarih 09.03.2021'dir. Daha önceki tarih değerleri 09.03.2021'e zorlanır.

partnerHotelDisplayName değerleri, büyük/küçük harfe duyarlı değildir.

Geçerli koşul örnekleri şunlardır:

  • 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 segmentlere ayrılacağını belirtir. Örneğin userRegionCode öğesi belirtilirse freeBookingLinksResult, kullanıcı bölgesine göre toplu metrikleri sağlar.

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

integer

Döndürülecek maksimum katılım sonucu sayısı. Hizmet bu değerden daha az değer döndürebilir. Belirtilmemesi halinde 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 birKatılımReportViews.query isteğinden alınan sayfa jetonu. Sonraki sayfayı almak için bunu girin.

Sayfalara ayırma sırasında, reportReports.query'ya 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 gövdesi

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

KULLANIMDAN KALDIRILDI: PropertyPerformanceReportService yerine QueryPropertyPerformanceReportResponse kullanın. FreeBookingLinksReportService.QueryFreeBookingLinksReport için yanıt mesajı.

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

object (FreeBookingLinksResult)

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

string

Sonraki sonuç sayfasını almak için kullanılan sayfalara ayırma jetonu. Bu alan çıkarılırsa sonraki sayfalar görünmez.

Yetkilendirme Kapsamları

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

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış konusuna bakın.

FreeBookingLinksResult sonucu

KULLANIMDAN KALDIRILDI: PropertyPerformanceReportService yerine PropertyPerformanceResult kullanın. Bir hesap için ücretsiz rezervasyon bağlantısı istatistikleri sorgulandığında elde edilen bir sonucu 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ığındaki bir tarih.

Yalnızca istekte aggregateBy içinde date belirtilmişse mevcuttur.
userRegionCode

string

Kullanıcının ülkesinin/bölgesinin ISO 3116 bölge kodu.

Yalnızca istekte aggregateBy öğesinde userRegionCode belirtilirse gösterilir
deviceType

enum (Device)

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

Yalnızca istekte aggregateBy içinde deviceType belirtilmişse mevcuttur.
partnerHotelId

string

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

Yalnızca istekte aggregateBy içinde partnerHotelId belirtilmişse mevcuttur.
partnerHotelDisplayName

string

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

Yalnızca istekte aggregateBy içinde partnerHotelDisplayName belirtilmişse mevcuttur.
clickCount

string (int64 format)

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