- Richiesta HTTP
- Parametri del percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- MonthlyRange
- SearchKeywordCount
- InsightsValue
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?monthlyRange.start_month.year=2022&monthlyRange.start_month.month=1&monthlyRange.end_month.year=2022&monthlyRange.end_month.month=3
Richiesta HTTP
GET https://businessprofileperformance.googleapis.com/v1/{parent=locations/*}/searchkeywords/impressions/monthly
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
parent |
Obbligatorio. La località per cui deve essere recuperata la serie temporale. Formato: locations/{locationId} dove locationId è un ID scheda non offuscato. |
Parametri di ricerca
Parametri | |
---|---|
monthlyRange |
Obbligatorio. L'intervallo in mesi durante il quale aggregare le impressioni delle parole chiave per la rete di ricerca. |
pageSize |
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. |
pageToken |
Campo facoltativo. Un token che indica il successivo risultato impaginato da restituire. Una stringa con codifica Base64. |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Rappresenta la risposta per monthly.list.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"searchKeywordsCounts": [
{
object ( |
Campi | |
---|---|
searchKeywordsCounts[] |
Termini di ricerca che sono stati utilizzati per trovare un'attività. |
nextPageToken |
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. Una stringa con codifica Base64. |
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.
MonthlyRange
Intervallo di tempo che indica un intervallo di mesi (entrambi inclusi).
Rappresentazione JSON |
---|
{ "startMonth": { object ( |
Campi | |
---|---|
startMonth |
Obbligatorio. Inclusivo: verranno presi in considerazione solo i campi dell'anno e dei mesi |
endMonth |
Obbligatorio. Inclusivo: verranno presi in considerazione solo i campi dell'anno e dei mesi |
SearchKeywordCount
Rappresenta una singola parola chiave per la rete di ricerca e il relativo valore.
Rappresentazione JSON |
---|
{
"searchKeyword": string,
"insightsValue": {
object ( |
Campi | |
---|---|
searchKeyword |
La stringa in lettere minuscole immessa dall'utente. |
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. |
InsightsValue
Rappresenta un valore degli insight.
Rappresentazione JSON |
---|
{ // Union field |
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 |
Rappresenta il valore effettivo. |
threshold |
Rappresenta la soglia al di sotto della quale ricade il valore effettivo. |