- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- MonthlyRange
- SearchKeywordCount
- InsightsValue
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 |
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 |
Obligatorio. Es el rango en meses en que se agregan las impresiones de palabras clave de la Búsqueda. |
pageSize |
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 |
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 ( |
Campos | |
---|---|
searchKeywordsCounts[] |
Términos de búsqueda que se utilizaron para encontrar una empresa. |
nextPageToken |
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 ( |
Campos | |
---|---|
startMonth |
Obligatorio. Inclusivo: Solo se considerarán los campos de año y mes. |
endMonth |
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 ( |
Campos | |
---|---|
searchKeyword |
Es la cadena en minúscula que ingresó el usuario. |
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 |
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 |
Representa el valor real. |
threshold |
Representa el umbral por debajo del cual se encuentra el valor real. |