Method: locations.searchkeywords.impressions.monthly.list

Restituisce le parole chiave per la rete di ricerca utilizzate per trovare un'attività nella ricerca o in Maps. Ogni parola chiave per la rete 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

string

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

Parametri di query

Parametri
monthlyRange

object (MonthlyRange)

Obbligatorio. L'intervallo in mesi in cui aggregare le impressioni delle parole chiave per la rete di ricerca.
pageSize

integer

(Facoltativo) Il numero di risultati richiesti. La dimensione predefinita della pagina è 100. Le dimensioni della pagina possono essere impostate fino a un massimo di 100.
pageToken

string (bytes format)

(Facoltativo) Un token che indica il risultato impaginato successivo 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 (SearchKeywordCount)
    }
  ],
  "nextPageToken": string
}
Campi
searchKeywordsCounts[]

object (SearchKeywordCount)

Termini di ricerca utilizzati per trovare un'attività commerciale.
nextPageToken

string (bytes format)

Un token che indica l'ultimo risultato impaginato restituito. Può essere utilizzato completando le richieste per ottenere la "pagina" successiva di parole chiave. Sarà presente solo quando ci sono più risultati da restituire.

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 mensile (entrambi inclusi).

Rappresentazione JSON 
{
  "startMonth": {
    object (Date)
  },
  "endMonth": {
    object (Date)
  }
}
Campi
startMonth

object (Date)

Obbligatorio. Inclusivo: verranno presi in considerazione solo i campi dell'anno e del mese
endMonth

object (Date)

Obbligatorio. Inclusivo: verranno presi in considerazione solo i campi dell'anno e del mese

SearchKeywordCount

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

Rappresentazione JSON 
{
  "searchKeyword": string,
  "insightsValue": {
    object (InsightsValue)
  }
}
Campi
searchKeyword

string

La stringa minuscola immessa dall'utente.
insightsValue

object (InsightsValue)

Uno dei seguenti elementi: 1) somma del numero di utenti unici che hanno utilizzato la parola chiave in un mese, aggregati 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 InsightsValue can be only one of the following:
  "value": string,
  "threshold": string
  // End of list of possible types for union field InsightsValue.
}
Campi
Campo unione InsightsValue. Rappresenta che deve essere presente solo uno dei seguenti campi di protocollo. InsightsValue può essere solo uno dei seguenti:
value

string (int64 format)

Rappresenta il valore effettivo.
threshold

string (int64 format)

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