Method: locations.searchkeywords.impressions.monthly.list

Muestra las palabras clave de búsqueda utilizadas para encontrar una empresa en la Búsqueda o Maps. Cada palabra clave de la Búsqueda va acompañada de impresiones que se agregan de forma mensual.

Ejemplo de solicitud: 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

Solicitud HTTP

GET https://businessprofileperformance.googleapis.com/v1/{parent=locations/*}/searchkeywords/impressions/monthly

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. La ubicación para la que se debe recuperar la serie temporal. Formato: locations/{locationId}, donde locationId es un ID de ficha no ofuscado.

Parámetros de consulta

Parámetros
monthlyRange

object (MonthlyRange)

Obligatorio. El rango en meses para agregar las impresiones de palabras clave de la Búsqueda.
pageSize

integer

Opcional. La cantidad de resultados solicitados. El tamaño de página predeterminado es 100. El tamaño de página se puede establecer en un máximo de 100.
pageToken

string (bytes format)

Opcional. Un token que indica el siguiente resultado paginado que se mostrará.

String codificada en base64.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Representa la respuesta de monthly.list.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "searchKeywordsCounts": [
    {
      object (SearchKeywordCount)
    }
  ],
  "nextPageToken": string
}
Campos
searchKeywordsCounts[]

object (SearchKeywordCount)

Términos de búsqueda que se usaron para encontrar una empresa.
nextPageToken

string (bytes format)

Un token que indica el último resultado paginado que se mostró. Esto se puede usar con solicitudes correctas para obtener la siguiente "página" de palabras clave. Solo estará presente cuando haya más resultados para devolver.

String codificada en base64.

Alcances de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/business.manage

Para obtener más información, consulta la descripción general de OAuth 2.0.

MonthlyRange

Es el intervalo de tiempo que indica un intervalo mensual (ambos inclusive).

Representación JSON 
{
  "startMonth": {
    object (Date)
  },
  "endMonth": {
    object (Date)
  }
}
Campos
startMonth

object (Date)

Obligatorio. Inclusivo: Solo se considerarán los campos año y meses.
endMonth

object (Date)

Obligatorio. Inclusivo: Solo se considerarán los campos año y meses.

SearchKeywordCount

Representa una sola palabra clave de búsqueda y su valor.

Representación JSON 
{
  "searchKeyword": string,
  "insightsValue": {
    object (InsightsValue)
  }
}
Campos
searchKeyword

string

Es la cadena en minúsculas que ingresó el usuario.
insightsValue

object (InsightsValue)

Una de las siguientes opciones: 1) La suma de la cantidad de usuarios únicos que utilizaron la palabra clave en un mes, agregada para cada mes solicitado. 2) Un umbral que indica que el valor real está por debajo de este umbral.

InsightsValue

Representa un valor de estadísticas.

Representación 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.
}
Campos
Campo de unión InsightsValue. Representa que solo uno de los siguientes campos proto debe estar presente. Las direcciones (InsightsValue) solo pueden ser una de las siguientes opciones:
value

string (int64 format)

Representa el valor real.
threshold

string (int64 format)

Representa el umbral por debajo del cual se encuentra el valor real.