Method: accounts.freeBookingLinksReportViews.query

OBSOLETO. Utilizza PropertyPerformanceReportService.QueryPropertyPerformanceReport, che contiene invece i report sulle impressioni. Fornisce la possibilità di eseguire query (ottenere, filtrare e segmentare) un report sui link di prenotazione gratuiti per un account specifico.

Richiesta HTTP

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

L'URL utilizza la sintassi gRPC Transcoding.

Parametri del percorso

Parametri
name

string

Il nome della risorsa dell'account su cui viene eseguita la query. Formato: accounts/{account_id}

Parametri di ricerca

Parametri
filter

string

Le condizioni (campi ed espressioni) utilizzate per filtrare le metriche del link di prenotazione gratuito per l'account su cui viene eseguita la query. La sintassi richiede spazi che circondano l'operatore in. In caso contrario, gli spazi possono essere omessi. È possibile unire le condizioni utilizzando l'operatore and.

Il campo date è obbligatorio. Tutti gli altri campi sono facoltativi.

I valori del campo date sono inclusi e devono essere in formato AAAA-MM-GG. La prima data accettabile è il 09/03/2021; i valori della data precedente verranno forzati fino al 09/03/2021.

I valori relativi a partnerHotelDisplayName non vengono sensibili alle maiuscole.

Ecco alcuni esempi di condizioni valide:

  • 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

Specifica come segmentare le metriche restituite dalla query. Ad esempio, se userRegionCode viene specificato, freeBookingLinksResult fornirà le metriche aggregate per area geografica utente.

Il valore stringa è un elenco di campi separato da virgole. I campi validi sono: date, userRegionCode, deviceType, partnerHotelId e partnerHotelDisplayName. Solo i campi specificati qui sono inclusi in FreeBookingLinksResult.
pageSize

integer

Il numero massimo di risultati di partecipazione da restituire. Il servizio potrebbe restituire un valore inferiore a questo valore. Se non viene specificato un valore, verranno restituiti al massimo 10.000 risultati. Il valore massimo è 10.000; i valori superiori a 10.000 verranno forzati a 10.000.
pageToken

string

Un token di pagina, ricevuto da una precedente richiestareportReportViews.query Forniscilo per ricevere la pagina successiva.

Durante l'impaginazione, tutti gli altri parametri forniti a PartecipaReportViews.query devono corrispondere alla chiamata che ha fornito il token della pagina.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

DEPRECATO:usa QueryPropertyPerformanceReportResponse con PropertyPerformanceReportService. Messaggio di risposta per FreeBookingLinksReportService.QueryFreeBookingLinksReport.

Rappresentazione JSON 
{
  "results": [
    {
      object (FreeBookingLinksResult)
    }
  ],
  "nextPageToken": string
}
Campi
results[]

object (FreeBookingLinksResult)

L'elenco dei risultati che corrispondono alla query.
nextPageToken

string

Token di impaginazione utilizzato per recuperare la pagina successiva dei risultati. Se questo campo viene omesso, non verranno visualizzate altre pagine.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per scoprire di più, consulta la Panoramica di OAuth 2.0.

Risultato LinkPrenotazione Free

DEPRECATO: usa PropertyPerformanceResult con PropertyPerformanceReportService. Rappresenta un risultato dell'esecuzione di query per le statistiche dei link di prenotazione gratuiti per un account.

Rappresentazione JSON 
{
  "date": {
    object (Date)
  },
  "userRegionCode": string,
  "deviceType": enum (Device),
  "partnerHotelId": string,
  "partnerHotelDisplayName": string,
  "clickCount": string
}
Campi
date

object (Date)

Una data compresa nell'intervallo di date richiesto.

Presente solo se date è specificato in aggregateBy nella richiesta.
userRegionCode

string

Codice regione ISO 3116 del paese/area geografica dell'utente.

Presente solo se userRegionCode è specificato in aggregateBy nella richiesta
deviceType

enum (Device)

Il tipo di dispositivo dell'utente.

Presente solo se deviceType è specificato in aggregateBy nella richiesta.
partnerHotelId

string

ID hotel del partner.

Presente solo se partnerHotelId è specificato in aggregateBy nella richiesta.
partnerHotelDisplayName

string

Nome dell'hotel del partner.

Presente solo se partnerHotelDisplayName è specificato in aggregateBy nella richiesta.
clickCount

string (int64 format)

Il numero totale di clic registrati per questo risultato.