Method: locations.searchkeywords.impressions.monthly.list

Muestra las palabras clave de la Búsqueda que se utilizaron para encontrar un negocio en la Búsqueda o Maps. Cada palabra clave de la Búsqueda está acompañada de impresiones que se agregan mensualmente.

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 deben recuperar las series temporales. Formato: ubicaciones/{locationId}, en el que locationId es un ID de ficha no ofuscado.

Parámetros de consulta

Parámetros
monthlyRange

object (MonthlyRange)

Obligatorio. Es el rango en meses en que se agregan las impresiones de palabras clave de la Búsqueda.
pageSize

integer

Opcional. Es la cantidad de resultados solicitados. El tamaño predeterminado de la página 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 utilizaron para encontrar una empresa.
nextPageToken

string (bytes format)

Un token que indica el último resultado paginado que se mostró. Esto puede usarse para completar las solicitudes de forma correcta para obtener la siguiente "página" de palabras clave. Solo estará presente cuando se deban mostrar más resultados.

String codificada en base64.

Permisos 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

Período que indica un intervalo mensual (ambos incluidos).

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

object (Date)

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

object (Date)

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

SearchKeywordCount

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

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

string

Es la cadena en minúscula 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 y la suma de 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 debe estar presente uno de los siguientes campos proto. 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.