Method: accounts.locations.reportInsights

Retorna um relatório com insights sobre uma ou mais métricas por local.

Solicitação HTTP

POST https://mybusiness.googleapis.com/v4/{name=accounts/*}/locations:reportInsights

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

O nome do recurso da conta.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "locationNames": [
    string
  ],
  "basicRequest": {
    object (BasicMetricsRequest)
  },
  "drivingDirectionsRequest": {
    object (DrivingDirectionMetricsRequest)
  }
}
Campos
locationNames[]

string

Uma coleção de locais para buscar insights, especificados pelos nomes.

basicRequest

object (BasicMetricsRequest)

Uma solicitação para incluir insights de métricas básicas no relatório.

drivingDirectionsRequest

object (DrivingDirectionMetricsRequest)

Uma solicitação para incluir insights sobre solicitações de rotas de carro no relatório.

Corpo da resposta

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Mensagem de resposta para Insights.ReportLocationInsights.

Representação JSON
{
  "locationMetrics": [
    {
      object (LocationMetrics)
    }
  ],
  "locationDrivingDirectionMetrics": [
    {
      object (LocationDrivingDirectionMetrics)
    }
  ]
}
Campos
locationMetrics[]

object (LocationMetrics)

Uma coleção de valores de métricas por local.

locationDrivingDirectionMetrics[]

object (LocationDrivingDirectionMetrics)

Uma coleção de valores para gerar métricas relacionadas a direções.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.

DrivingDirectionMetricsRequest

Uma solicitação de insights de rotas de carro.

Representação JSON
{
  "numDays": enum (NumDays),
  "languageCode": string
}
Campos
numDays

enum (NumDays)

O número de dias para agregar dados. Os resultados retornados serão dados disponíveis dos últimos dias solicitados. Os valores válidos são 7, 30 e 90.

languageCode

string

O código BCP 47 do idioma. Se um código de idioma não for fornecido, o padrão será inglês.

NumDays

Número de dias que essa solicitação pode suportar.

Enums
SEVEN 7 dias. Esse é o valor padrão.
THIRTY 30 dias.
NINETY 90 dias.

LocationMetrics

Uma série de métricas e DetalhamentoMetrics associadas a um local em um período de tempo.

Representação JSON
{
  "locationName": string,
  "timeZone": string,
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Campos
locationName

string

O nome do recurso de local a que esses valores pertencem.

timeZone

string

Fuso horário da IANA para o local.

metricValues[]

object (MetricValue)

Uma lista de valores para as métricas solicitadas.

LocationDrivingDirectionMetrics

Um local indexado com as regiões de origem das pessoas. Isso é registrado contando quantas solicitações de rotas de carro para esse local são de cada região.

Representação JSON
{
  "locationName": string,
  "topDirectionSources": [
    {
      object (TopDirectionSources)
    }
  ],
  "timeZone": string
}
Campos
locationName

string

O nome do recurso de local ao qual o valor da métrica pertence.

topDirectionSources[]

object (TopDirectionSources)

Solicitações de rotas de carro por região de origem. Por convenção, estes são classificados por contagem, com no máximo 10 resultados.

timeZone

string

Fuso horário (IDs de fuso horário IANA, por exemplo, "Europa/Londres") do local.

TopDirectionSources

Principais regiões de origem das solicitações de rotas de carro.

Representação JSON
{
  "dayCount": integer,
  "regionCounts": [
    {
      object (RegionCount)
    }
  ]
}
Campos
dayCount

integer

O número de dias em que os dados são agregados.

regionCounts[]

object (RegionCount)

Regiões classificadas em ordem decrescente por contagem.

RegionCount

Uma região com a contagem de solicitações associadas.

Representação JSON
{
  "latlng": {
    object (LatLng)
  },
  "label": string,
  "count": string
}
Campos
latlng

object (LatLng)

Centro da região.

label

string

Rótulo legível para a região.

count

string (int64 format)

Número de solicitações de rota de carro dessa região.