Package google.mybusiness.performance.v1

Indice

PerformanceService

Questo servizio consente ai commercianti di recuperare i report sul rendimento relativi al profilo della loro attività su Google.

L'API tenta di seguire le linee guida riportate su aip.dev.

FetchMultiDailyMetricsTimeSeries

rpc FetchMultiDailyMetricsTimeSeries(FetchMultiDailyMetricsTimeSeriesRequest) returns (FetchMultiDailyMetricsTimeSeriesResponse)

Restituisce i valori per ogni data di un determinato intervallo di tempo e, facoltativamente, il tipo di entità secondaria, ove applicabile, associati alle metriche giornaliere specifiche.

Esempio di richiesta: GET https://businessprofileperformance.googleapis.com/v1/locations/12345:fetchMultiDailyMetricsTimeSeries?dailyMetrics=WEBSITE_CLICKS&dailyMetrics=CALL_CLICKS&daily_range.start_date.year=2022&daily_range.start_date.month=1&daily_range.start_date.day=1&daily_range.end_date.year=2022&daily_range.end_date.month=3&daily_range.end_date.day=31

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

rpc GetDailyMetricsTimeSeries(GetDailyMetricsTimeSeriesRequest) returns (GetDailyMetricsTimeSeriesResponse)

Restituisce i valori di ogni data di un determinato intervallo di tempo associati alla metrica giornaliera specifica.

Esempio di richiesta: GET https://businessprofileperformance.googleapis.com/v1/locations/12345:getDailyMetricsTimeSeries?dailyMetric=WEBSITE_CLICKS&daily_range.start_date.year=2022&daily_range.start_date.month=1&daily_range.start_date.day=1&daily_range.end_date.year=2022&daily_range.end_date.month=3&daily_range.end_date.day=31

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

rpc ListSearchKeywordImpressionsMonthly(ListSearchKeywordImpressionsMonthlyRequest) returns (ListSearchKeywordImpressionsMonthlyResponse)

Restituisce le parole chiave di ricerca utilizzate per trovare un'attività nella ricerca o in Maps. Ogni parola chiave di ricerca è accompagnata da impressioni che vengono aggregate su base mensile.

Esempio di richiesta: GET https://businessprofileperformance.googleapis.com/v1/locations/12345/searchkeywords/impressions/monthly?monthly_range.start_month.year=2022&monthly_range.start_month.month=1&monthly_range.end_month.year=2022&monthly_range.end_month.month=3

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.

DailyMetric

Rappresenta tutte le metriche giornaliere disponibili per un'attività.

Enum
DAILY_METRIC_UNKNOWN Rappresenta il valore sconosciuto predefinito.
BUSINESS_IMPRESSIONS_DESKTOP_MAPS Impressioni di attività su Google Maps da computer. Più impressioni di un utente unico nello stesso giorno vengono conteggiate come un'unica impressione.
BUSINESS_IMPRESSIONS_MOBILE_MAPS Impressioni di attività su Google Maps sui dispositivi mobili. Più impressioni di un utente unico nello stesso giorno vengono conteggiate come un'unica impressione.
BUSINESS_CONVERSATIONS Il numero di conversazioni di messaggi ricevute nel profilo dell'attività.
BUSINESS_DIRECTION_REQUESTS Il numero di volte in cui è stata richiesta una richiesta di indicazioni stradali alla sede dell'attività.
CALL_CLICKS Il numero di volte in cui è stato fatto clic sul pulsante di chiamata del profilo dell'attività.
WEBSITE_CLICKS Il numero di volte in cui è stato fatto clic sul sito web del profilo dell'attività.
BUSINESS_BOOKINGS Il numero di prenotazioni effettuate dal profilo dell'attività tramite Prenota con Google.
BUSINESS_FOOD_ORDERS Il numero di ordini di cibo ricevuti dal profilo dell'attività.
BUSINESS_FOOD_MENU_CLICKS Il numero di clic per visualizzare o interagire con i contenuti del menu nel profilo dell'attività. Più clic di un utente unico in un giorno vengono conteggiati come uno.

DailyMetricTimeSeries

Rappresenta un singolo punto dati, in cui ogni punto dati è una tupla DailyMetric-DailySubEntityType-TimeSeries.

Campi
daily_metric

DailyMetric

DailyMetric rappresentato da TimeSeries.
daily_sub_entity_type

DailySubEntityType

Il DailySubEntityType rappresentato dalla serie temporale. Non sarà presente quando non esiste la suddivisione.
time_series

TimeSeries

Elenco di punti dati in cui ogni punto dati è una coppia data-valore.

DailyRange

Intervallo di tempo che indica un intervallo di date (entrambi inclusi).

Campi
start_date

Date

Obbligatorio. Inclusivi
end_date

Date

Obbligatorio. Inclusivi

DailySubEntityType

Rappresenta tutti i possibili tipi di sottoentità associati a DailyMetrics.

Campi
Campo di unione Type. Rappresenta che deve essere presente solo uno dei seguenti campi di protocollo. DailySubEntityType non è disponibile per tutte le metriche. Type può essere solo uno dei seguenti:
day_of_week

DayOfWeek

Rappresenta il giorno della settimana. Esempio: LUNEDÌ. DailyMetrics attualmente supportato = NESSUNO.
time_of_day

TimeOfDay

Rappresenta l'ora del giorno nel formato 24 ore. Es.: 13:34:20 DailyMetrics attualmente supportato = NESSUNO.

DatedValue

Rappresenta un singolo punto dati nelle serie temporali, dove ogni punto dati è una coppia data-valore.

Campi
date

Date

La data a cui corrisponde il punto dati. Rappresenta il valore del mese se il campo del giorno non è impostato.
value

int64

Il valore del punto dati. Non sarà presente quando il valore è zero.

FetchMultiDailyMetricsTimeSeriesRequest

Rappresenta la richiesta per FetchMultiDailyMetricsTimeSeries.

Campi
location

string

Obbligatorio. La località per cui deve essere recuperata la serie temporale. Formato: locations/{location_id} dove location_id è un ID scheda non offuscato.
daily_metrics[]

DailyMetric

Obbligatorio. Le metriche per cui recuperare le serie temporali.
daily_range

DailyRange

Obbligatorio. L'intervallo di tempo per il quale verrà recuperata la serie temporale.

FetchMultiDailyMetricsTimeSeriesResponse

Rappresenta la risposta per FetchMultiDailyMetricsTimeSeries.

Campi
multi_daily_metric_time_series[]

MultiDailyMetricTimeSeries

DailyMetrics e le corrispondenti serie temporali.

GetDailyMetricsTimeSeriesRequest

Rappresenta la richiesta per GetDailyMetricsTimeSeries.

Campi
name

string

Obbligatorio. La località per cui deve essere recuperata la serie temporale. Formato: locations/{location_id} dove location_id è un ID scheda non offuscato.
daily_metric

DailyMetric

Obbligatorio. La metrica per recuperare le serie temporali.
daily_range

DailyRange

Obbligatorio. L'intervallo di tempo per il quale verrà recuperata la serie temporale.
daily_sub_entity_type

DailySubEntityType

Campo facoltativo. Il tipo e l'ID di sottoentità a cui fa riferimento la serie temporale. DailyMetrics attualmente supportato = NESSUNO.

GetDailyMetricsTimeSeriesResponse

Rappresenta la risposta per GetDailyMetricsTimeSeries.

Campi
time_series

TimeSeries

Le serie temporali giornaliere.

InsightsValue

Rappresenta un valore degli insight.

Campi
Campo di unione InsightsValue. Rappresenta che deve essere presente solo uno dei seguenti campi di protocollo. InsightsValue può essere solo uno dei seguenti:
value

int64

Rappresenta il valore effettivo.
threshold

int64

Rappresenta la soglia al di sotto della quale ricade il valore effettivo.

ListSearchKeywordImpressionsMonthlyRequest

Rappresenta la richiesta per ListSearchKeywordImpressionsmonthly.

Campi
parent

string

Obbligatorio. La località per cui deve essere recuperata la serie temporale. Formato: locations/{location_id} dove location_id è un ID scheda non offuscato.
monthly_range

MonthlyRange

Obbligatorio. L'intervallo in mesi durante il quale aggregare le impressioni delle parole chiave per la rete di ricerca.
page_size

int32

Campo facoltativo. Il numero di risultati richiesti. La dimensione predefinita della pagina è 100. Le dimensioni della pagina possono essere impostate su un massimo di 100.
page_token

bytes

Campo facoltativo. Un token che indica il successivo risultato impaginato da restituire.

ListSearchKeywordImpressionsMonthlyResponse

Rappresenta la risposta per ListSearchKeywordImpressions Monthly.

Campi
search_keywords_counts[]

SearchKeywordCount

Termini di ricerca che sono stati utilizzati per trovare un'attività.
next_page_token

bytes

Un token che indica l'ultimo risultato impaginato restituito. Può essere utilizzato da richieste successive per ottenere la "pagina" di parole chiave successiva. Viene visualizzata solo quando vengono restituiti più risultati.

MonthlyRange

Intervallo di tempo che indica un intervallo di mesi (entrambi inclusi).

Campi
start_month

Date

Obbligatorio. Inclusivo: verranno presi in considerazione solo i campi dell'anno e dei mesi
end_month

Date

Obbligatorio. Inclusivo: verranno presi in considerazione solo i campi dell'anno e dei mesi

MultiDailyMetricTimeSeries

Rappresenta un elenco di tuple di DailyMetric-DailySubEntityType-TimeSeries.

Campi
daily_metric_time_series[]

DailyMetricTimeSeries

Elenco di coppie DailyMetric-TimeSeries.

SearchKeywordCount

Rappresenta una singola parola chiave per la rete di ricerca e il relativo valore.

Campi
search_keyword

string

La stringa in lettere minuscole immessa dall'utente.
insights_value

InsightsValue

Uno dei due seguenti valori: 1) La somma del numero di utenti unici che hanno utilizzato la parola chiave in un mese, aggregata per ogni mese richiesto. 2) Una soglia che indica che il valore effettivo è inferiore a questa soglia.

TimeSeries

Rappresenta una serie temporale.

Campi
dated_values[]

DatedValue

Elenco di punti dati nelle serie temporali, in cui ogni punto dati è una coppia data-valore.