Method: locations.businesscallsinsights.list

Restituisce informazioni sulle chiamate alle attività commerciali 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 sede principale per cui recuperare le statistiche sulle chiamate. Formato: locations/{locationId}

Parametri di query

Parametri
pageSize

integer

(Facoltativo) Il numero massimo di BusinessCallsInsights da restituire. Se non specificato, verranno restituiti al massimo 20. Alcuni dei parametri metric_types(ad es.AGGREGATE_COUNT) restituiscono una singola pagina. Per queste metriche, pageSize viene ignorato.
pageToken

string

(Facoltativo) Un token di pagina, ricevuto da una precedente chiamata a businesscallsinsights.list. Forniscilo 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 dei parametri metric_types (ad es.AGGREGATE_COUNT) restituiscono una singola pagina. Per queste metriche, il pake_token viene ignorato.
filter

string

(Facoltativo) Un filtro che vincola gli insight sulle chiamate da restituire. La risposta include solo le voci che corrispondono al filtro.

Se il valore MetricType non viene specificato, viene restituito AGGREGATE_COUNT. Se non viene specificata alcuna data di fine, viene utilizzata l'ultima data per cui sono disponibili i dati. Se non viene specificata alcuna data di inizio, per impostazione predefinita utilizzeremo la prima data per la quale sono disponibili i dati, che al momento corrisponde a 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="DATA" dove la data è nel formato AAAA-MM-GG. 2. endDate="DATA" 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" Il valore metricType AGGREGATE_COUNT 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à 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 dei parametri metric_types (ad es.AGGREGATE_COUNT) restituiscono una singola pagina. Per queste metriche, il 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 verso 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 per cui si applica il valore.
aggregateMetrics

object (AggregateMetrics)

Metrica per l'intervallo di tempo basato 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 nell'intervallo di tempo 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 per questa metrica. Se la metrica è mensile, vengono utilizzati solo anno e 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. I valori consentiti sono 0-23.
missedCallsCount

integer

Conteggio totale di chiamate senza risposta per quest'ora.

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 di chiamate senza risposta per quest'ora.

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, come un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Può trattarsi di uno dei seguenti valori:

  • Una data completa, con valori diversi da zero per anno, mese e giorno
  • Un mese e un giorno con zero anni (ad es. un anniversario)
  • Un anno a sé stante, con uno zero mese e uno zero-day
  • Un anno e un mese, con zero-day (ad es. la data di scadenza della 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. Il valore deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno.
day

integer

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