Method: locations.searchkeywords.impressions.monthly.list

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

string

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

object (MonthlyRange)

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

integer

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

string (bytes format)

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 (SearchKeywordCount)
    }
  ],
  "nextPageToken": string
}
Campi
searchKeywordsCounts[]

object (SearchKeywordCount)

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

string (bytes format)

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 (Date)
  },
  "endMonth": {
    object (Date)
  }
}
Campi
startMonth

object (Date)

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

object (Date)

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 (InsightsValue)
  }
}
Campi
searchKeyword

string

La stringa in lettere minuscole immessa dall'utente.
insightsValue

object (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 InsightsValue can be only one of the following:
  "value": string,
  "threshold": string
  // End of list of possible types for union field InsightsValue.
}
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

string (int64 format)

Rappresenta il valore effettivo.
threshold

string (int64 format)

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