- Richiesta HTTP
- Parametri del percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- BusinessCallsInsights
- MetricType
- AggregateMetrics
- HourlyMetrics
- WeekDayMetrics
- DayOfWeek
- Data
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 |
Obbligatorio. La posizione principale per cui recuperare gli approfondimenti sulle chiamate. Formato: locations/{locationId} |
Parametri di ricerca
Parametri | |
---|---|
pageSize |
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 |
Campo facoltativo. Un token di pagina, ricevuto da una precedente chiamata a Durante l'impaginazione, tutti gli altri parametri forniti a |
filter |
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 ( |
Campi | |
---|---|
businessCallsInsights[] |
Una raccolta di informazioni sulle chiamate dell'attività commerciale per la sede. |
nextPageToken |
Un token, che può essere inviato come |
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 ( |
Campi | |
---|---|
name |
Obbligatorio. Il nome della risorsa degli insight sulle chiamate. Formato: locations/{location}/businesscallsinsights |
metricType |
La metrica a cui si applica il valore. |
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 ( |
Campi | |
---|---|
missedCallsCount |
Conteggio totale delle chiamate senza risposta. |
answeredCallsCount |
Conteggio totale delle chiamate con risposta. |
hourlyMetrics[] |
Un elenco di metriche per ora del giorno. |
weekdayMetrics[] |
Un elenco di metriche per giorno della settimana. |
startDate |
Data di questa metrica. Se la metrica è mensile, vengono utilizzati solo l'anno e il mese. |
endDate |
Data di fine per questa metrica. |
HourlyMetrics
Metriche per un'ora.
Rappresentazione JSON |
---|
{ "hour": integer, "missedCallsCount": integer } |
Campi | |
---|---|
hour |
Ora del giorno. Sono consentiti valori compresi tra 0 e 23. |
missedCallsCount |
Conteggio totale delle chiamate senza risposta nell'ora corrente. |
WeekDayMetrics
Metriche per un giorno della settimana.
Rappresentazione JSON |
---|
{
"day": enum ( |
Campi | |
---|---|
day |
Giorno della settimana. I valori consentiti sono da domenica a sabato. |
missedCallsCount |
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 |
Anno della data. Il valore deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno. |
month |
Mese dell'anno. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza giorno e mese. |
day |
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. |