Package google.mybusiness.businesscalls.v1

Indice

BusinessCallsService

Questa API consente alle attività di gestire le chiamate di lavoro e raccogliere informazioni quali il numero di chiamate senza risposta alla loro sede. Ulteriori informazioni sulle chiamate con le attività commerciali sono disponibili all'indirizzo https://support.google.com/business/answer/9688285?p=call_history

Se il Profilo dell'attività su Google si collega a un account Google Ads e la cronologia chiamate è attivata, le chiamate che durano più di un orario specifico e che possono essere attribuite a un'interazione con l'annuncio verranno visualizzate nell'account Google Ads collegato nella conversione "Chiamate dagli annunci". L'utilizzo di Smart Bidding e delle conversioni di chiamata nella strategia di ottimizzazione potrebbe comportare una variazione della spesa pubblicitaria. Scopri di più su Smart Bidding."

Per visualizzare ed eseguire azioni sulle chiamate a una località, devi essere un OWNER, CO_OWNER o MANAGER della località.

GetBusinessCallsSettings

rpc GetBusinessCallsSettings(GetBusinessCallsSettingsRequest) returns (BusinessCallsSettings)

Restituisce la risorsa delle impostazioni di chiamate aziendali per la località specificata.

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.
ListBusinessCallsInsights

rpc ListBusinessCallsInsights(ListBusinessCallsInsightsRequest) returns (ListBusinessCallsInsightsResponse)

Restituisce informazioni sulle chiamate aziendali per una sede.

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.
UpdateBusinessCallsSettings

rpc UpdateBusinessCallsSettings(UpdateBusinessCallsSettingsRequest) returns (BusinessCallsSettings)

Consente di aggiornare le impostazioni di chiamata dell'attività per la sede specificata.

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.

AggregateMetrics

Metriche aggregate nell'intervallo di tempo di input.

Campi
missed_calls_count

Int32Value

Conteggio totale delle chiamate senza risposta.
answered_calls_count

Int32Value

Conteggio totale delle chiamate con risposta.
hourly_metrics[]

HourlyMetrics

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

WeekDayMetrics

Un elenco di metriche per giorno della settimana.
start_date

Date

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

Date

Data di fine per questa metrica.

BusinessCallsInsights

Statistiche sulle chiamate effettuate a una località.

Campi
name

string

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

MetricType

La metrica a cui si applica il valore.
aggregate_metrics

AggregateMetrics

Metrica per l'intervallo di tempo basata su start_date e end_date.

BusinessCallsSettings

Impostazioni delle chiamate aziendali per una sede.

Campi
name

string

Obbligatorio. Il nome della risorsa delle impostazioni delle chiamate. Formato: locations/{location}/businesscallssettings
calls_state

CallsState

Obbligatorio. Lo stato della registrazione di questa sede alle chiamate Business.
consent_time

Timestamp

Solo input. L'ora in cui l'utente finale ha fornito all'utente API il consenso per abilitare le chiamate aziendali.

CallsState

I possibili stati di una sede nelle chiamate alle attività commerciali. Gli stati possono essere aggiornati solo su ENABLED (Abilitato) o DISABLED (DISABILITATO). Qualsiasi altra modifica restituirà l'errore PRECondition_FAILED.

Enum
CALLS_STATE_UNSPECIFIED Non specificato.
ENABLED Le chiamate di attività commerciali sono attive per la sede.
DISABLED Le chiamate di attività commerciali sono disattivate per la sede.

ErrorCode

Codici di errore per guasti interni.

Enum
ERROR_CODE_UNSPECIFIED Codice di errore non specificato.
ERROR_CODE_UNVERIFIED_LOCATION La sede non è verificata.
ERROR_CODE_CALLS_NOT_ENABLED Lo stato delle chiamate di attività per la sede non è ATTIVATO.
ERROR_CODE_NOT_ELIGIBLE_LOCATION La sede non è idonea per le chiamate con le attività commerciali.

GetBusinessCallsSettingsRequest

Messaggio di richiesta per GetBusinessCallsSettings.

Campi
name

string

Obbligatorio. Le BusinessCallsSettings da visualizzare.

Il campo name viene utilizzato per identificare le impostazioni di chiamata dell'attività da ricevere. Formato: locations/{location_id}/businesscallssettings.

HourlyMetrics

Metriche per un'ora.

Campi
hour

Int32Value

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

Int32Value

Conteggio totale delle chiamate senza risposta nell'ora corrente.

ListBusinessCallsInsightsRequest

Messaggio di richiesta per ListBusinessCallsInsights.

Campi
parent

string

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

int32

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, page_size viene ignorato.
page_token

string

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

Durante l'impaginazione, tutti gli altri parametri forniti a ListBusinessCallsInsights 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 specificato alcun valore end_date, viene utilizzata l'ultima data per la quale sono disponibili i dati. Se non viene specificato alcun valore start_date, il valore predefinito sarà la prima data per la quale sono disponibili i dati, che attualmente è di 6 mesi. Se start_date è 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. start_date="DATE" dove la data è nel formato AAAA-MM-GG. 2. end_date="DATE" dove la data è nel formato AAAA-MM-GG. 3. metric_type=XYZ dove XYZ è un MetricType valido. 4. Congiunzioni(AND) di tutte le risposte precedenti, ad es. "start_date=2021-08-01 AND end_date=2021-08-10 AND metric_type=AGGREGATE_COUNT" AGGREGATE_COUNT metric_type ignora la parte DD della data.

ListBusinessCallsInsightsResponse

Messaggio di risposta per ListBusinessCallsInsights.

Campi
business_calls_insights[]

BusinessCallsInsights

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

string

Un token, che può essere inviato come page_token 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 next_page_token sarà vuoto.

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.

UpdateBusinessCallsSettingsRequest

Messaggio di richiesta per UpdateBusinessCallsSettings.

Campi
business_calls_settings

BusinessCallsSettings

Obbligatorio. Impostazioni di chiamata Business da aggiornare.

Il campo name viene utilizzato per identificare le impostazioni di chiamata dell'attività da aggiornare. Formato: locations/{location_id}/businesscallssettings
update_mask

FieldMask

Obbligatorio. L'elenco di campi da aggiornare.

WeekDayMetrics

Metriche per un giorno della settimana.

Campi
day

DayOfWeek

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

Int32Value

Conteggio totale delle chiamate senza risposta nell'ora corrente.