Method: locations.businesscallsinsights.list

Restituisce informazioni sulle chiamate aziendali per una sede.

Richiesta HTTP

GET https://mybusinessbusinesscalls.googleapis.com/v1/{parent=locations/*}/businesscallsinsights

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. La posizione principale per cui recuperare gli approfondimenti sulle chiamate. Formato: locations/{locationId}

Parametri di ricerca

Parametri
pageSize

integer

Campo facoltativo. Il numero massimo di BusinessCallsInsights da restituire. Se non specificato, ne verranno restituiti al massimo 20. Alcuni valori metric_types, ad esempio AGGREGATE_COUNT, restituiscono una singola pagina. Per queste metriche, il valore pageSize viene ignorato.
pageToken

string

Campo facoltativo. Un token di pagina, ricevuto da una precedente chiamata a businesscallsinsights.list. Specifica questo valore per recuperare la pagina successiva.

Durante l'impaginazione, tutti gli altri parametri forniti a businesscallsinsights.list devono corrispondere alla chiamata che ha fornito il token della pagina. Alcuni valori metric_type (ad es.AGGREGATE_COUNT) restituiscono una singola pagina. Per queste metriche, pake_token viene ignorato.
filter

string

Campo facoltativo. Un filtro che vincola gli insight sulle chiamate da restituire. La risposta include solo le voci che corrispondono al filtro.

Se non viene fornito il valore MetricType, viene restituito AGGREGATE_COUNT. Se non viene fornito alcun valore endDate, viene utilizzata l'ultima data per cui sono disponibili i dati. Se non viene specificato alcun valore startDate, il valore predefinito è la prima data per cui sono disponibili i dati, che attualmente è di 6 mesi. Se la data di inizio è precedente alla data in cui sono disponibili i dati, i dati vengono restituiti a partire dalla data in cui sono disponibili.

Al momento supportiamo i seguenti filtri. 1. startDate="DATE" dove la data è nel formato AAAA-MM-GG. 2. endDate="DATE" dove la data è nel formato AAAA-MM-GG. 3. metricType=XYZ dove XYZ è un MetricType valido. 4. Congiunzioni(AND) di tutte le risposte precedenti, ad es. "startDate=2021-08-01 AND endDate=2021-08-10 AND metricType=AGGREGATE_COUNT" AGGREGATE_COUNT metricType ignora la parte DD della data.

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:

Messaggio di risposta per businesscallsinsights.list.

Rappresentazione JSON 
{
  "businessCallsInsights": [
    {
      object (BusinessCallsInsights)
    }
  ],
  "nextPageToken": string
}
Campi
businessCallsInsights[]

object (BusinessCallsInsights)

Una raccolta di informazioni sulle chiamate dell'attività commerciale per la sede.
nextPageToken

string

Un token, che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine. Alcuni valori metric_type (ad es.AGGREGATE_COUNT) restituiscono una singola pagina. Per queste metriche, il valore nextPageToken sarà vuoto.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/business.manage

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

BusinessCallsInsights

Statistiche sulle chiamate effettuate a una località.

Rappresentazione JSON 
{
  "name": string,
  "metricType": enum (MetricType),
  "aggregateMetrics": {
    object (AggregateMetrics)
  }
}
Campi
name

string

Obbligatorio. Il nome della risorsa degli insight sulle chiamate. Formato: locations/{location}/businesscallsinsights
metricType

enum (MetricType)

La metrica a cui si applica il valore.
aggregateMetrics

object (AggregateMetrics)

Metrica per l'intervallo di tempo basata su startDate e endDate.

MetricType

Il tipo di metrica.

Enum
METRIC_TYPE_UNSPECIFIED Il tipo di metrica non è specificato.
AGGREGATE_COUNT Le metriche fornite sono conteggi aggregati per l'intervallo time_range di input.

AggregateMetrics

Metriche aggregate nell'intervallo di tempo di input.

Rappresentazione JSON 
{
  "missedCallsCount": integer,
  "answeredCallsCount": integer,
  "hourlyMetrics": [
    {
      object (HourlyMetrics)
    }
  ],
  "weekdayMetrics": [
    {
      object (WeekDayMetrics)
    }
  ],
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
Campi
missedCallsCount

integer

Conteggio totale delle chiamate senza risposta.
answeredCallsCount

integer

Conteggio totale delle chiamate con risposta.
hourlyMetrics[]

object (HourlyMetrics)

Un elenco di metriche per ora del giorno.
weekdayMetrics[]

object (WeekDayMetrics)

Un elenco di metriche per giorno della settimana.
startDate

object (Date)

Data di questa metrica. Se la metrica è mensile, vengono utilizzati solo l'anno e il mese.
endDate

object (Date)

Data di fine per questa metrica.

HourlyMetrics

Metriche per un'ora.

Rappresentazione JSON 
{
  "hour": integer,
  "missedCallsCount": integer
}
Campi
hour

integer

Ora del giorno. Sono consentiti valori compresi tra 0 e 23.
missedCallsCount

integer

Conteggio totale delle chiamate senza risposta nell'ora corrente.

WeekDayMetrics

Metriche per un giorno della settimana.

Rappresentazione JSON 
{
  "day": enum (DayOfWeek),
  "missedCallsCount": integer
}
Campi
day

enum (DayOfWeek)

Giorno della settimana. I valori consentiti sono da domenica a sabato.
missedCallsCount

integer

Conteggio totale delle chiamate senza risposta nell'ora corrente.

DayOfWeek

Rappresenta un giorno della settimana.

Enum
DAY_OF_WEEK_UNSPECIFIED Il giorno della settimana non è specificato.
MONDAY Lunedì
TUESDAY Martedì
WEDNESDAY mercoledì
THURSDAY giovedì
FRIDAY venerdì
SATURDAY Sabato
SUNDAY domenica

Data

Rappresenta una data di calendario intera o parziale, ad esempio un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Può rappresentare uno dei seguenti valori:

  • Una data completa, con valori di anno, mese e giorno diversi da zero
  • Un mese e un giorno con zero anni (ad es. un anniversario)
  • Un anno autonomo, con un mese e uno zero
  • Un anno e un mese, con zero giorni (ad es. la data di scadenza di una carta di credito)

Tipi correlati: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp

Rappresentazione JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campi
year

integer

Anno della data. Il valore deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.
month

integer

Mese dell'anno. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza giorno e mese.
day

integer

Giorno del mese. Deve essere compreso tra 1 e 31 ed essere valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e un mese in cui il giorno non è significativo.