- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de la autorización
- BusinessCallsInsights
- MetricType
- AggregateMetrics
- HourlyMetrics
- WeekDayMetrics
- DayOfWeek
- Fecha
Muestra estadísticas de las llamadas a empresas para una ubicación.
Solicitud HTTP
GET https://mybusinessbusinesscalls.googleapis.com/v1/{parent=locations/*}/businesscallsinsights
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
parent |
Obligatorio. La ubicación superior para la que se recuperarán las estadísticas de llamadas. Formato: locations/{locationId} |
Parámetros de consulta
Parámetros | |
---|---|
pageSize |
Opcional. Es la cantidad máxima de BusinessCallsInsights que se debe mostrar. Si no se especifican, se mostrarán 20 como máximo. Algunos de metric_types(p. ej., AGGREGATE_COUNT) muestran una sola página. Para estas métricas, se ignora pageSize. |
pageToken |
Opcional. Un token de página, recibido desde una llamada Cuando se pagina, todos los demás parámetros proporcionados a |
filter |
Opcional. Un filtro que restringe las estadísticas de llamadas para que se muestren. La respuesta solo incluye entradas que coinciden con el filtro. Si no se proporciona MetricType, se muestra AGGREGATE_COUNT. Si no se proporciona endDate, se utiliza la última fecha para la que hay datos disponibles. Si no se proporciona startDate, usaremos de forma predeterminada la primera fecha de la que haya datos disponibles, que actualmente es de 6 meses. Si startDate es anterior a la fecha en que los datos están disponibles, los datos se muestran a partir de la fecha en que están disponibles. En este momento, admitimos los siguientes filtros. 1. fechadeinicio="DATE" donde la fecha esté en formato AAAA-MM-DD. 2. endDate="DATE" donde la fecha esté en formato AAAA-MM-DD. 3. metricType=XYZ, en el que XYZ es un MetricType válido 4. Conjunciones(AND) de todo lo anterior. p.ej., "startDate=2021-08-01 AND endDate=2021-08-10 AND metricType=AGGREGATE_COUNT" El AGGREGATE_COUNT metricType ignora la parte del DD de la fecha. |
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Mensaje de respuesta para businesscallsinsights.list.
Representación JSON |
---|
{
"businessCallsInsights": [
{
object ( |
Campos | |
---|---|
businessCallsInsights[] |
Es una colección de estadísticas de llamadas a empresas de la ubicación. |
nextPageToken |
Un token, que se puede enviar como |
Alcances de la 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.
BusinessCallsInsights
Estadísticas de las llamadas realizadas a una ubicación.
Representación JSON |
---|
{ "name": string, "metricType": enum ( |
Campos | |
---|---|
name |
Obligatorio. El nombre del recurso de las estadísticas de llamadas. Formato: locations/{location}/businesscallsinsights |
metricType |
La métrica para la que se aplica el valor. |
aggregateMetrics |
Es una métrica del intervalo de tiempo basado en startDate y endDate. |
MetricType
Es el tipo de métrica.
Enumeraciones | |
---|---|
METRIC_TYPE_UNSPECIFIED |
No se especifica el tipo de métrica. |
AGGREGATE_COUNT |
Las métricas proporcionadas son recuentos agregados en el intervalo de tiempo de entrada. |
AggregateMetrics
Son métricas agregadas durante el intervalo de tiempo de entrada.
Representación JSON |
---|
{ "missedCallsCount": integer, "answeredCallsCount": integer, "hourlyMetrics": [ { object ( |
Campos | |
---|---|
missedCallsCount |
Recuento total de llamadas perdidas. |
answeredCallsCount |
Recuento total de llamadas contestadas. |
hourlyMetrics[] |
Una lista de métricas por hora del día. |
weekdayMetrics[] |
Una lista de métricas por día de la semana |
startDate |
Es la fecha de esta métrica. Si la métrica es mensual, solo se usan el año y el mes. |
endDate |
Es la fecha de finalización de esta métrica. |
HourlyMetrics
Métricas por una hora.
Representación JSON |
---|
{ "hour": integer, "missedCallsCount": integer } |
Campos | |
---|---|
hour |
Hora del día. Se permiten valores incluidos en el rango del 0 al 23. |
missedCallsCount |
Recuento total de llamadas perdidas durante esta hora. |
WeekDayMetrics
Métricas para un día de la semana.
Representación JSON |
---|
{
"day": enum ( |
Campos | |
---|---|
day |
Día de la semana. Los valores permitidos son de domingo a sábado. |
missedCallsCount |
Recuento total de llamadas perdidas durante esta hora. |
DayOfWeek
Representa un día de la semana.
Enumeraciones | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
No se especifica el día de la semana. |
MONDAY |
Lunes |
TUESDAY |
Martes |
WEDNESDAY |
Miércoles |
THURSDAY |
Jueves |
FRIDAY |
Viernes |
SATURDAY |
Sábado |
SUNDAY |
Domingo |
Fecha
Representa una fecha de calendario completa o parcial, como un cumpleaños. La hora del día y la zona horaria se especifican en otro lugar o son insignificantes. La fecha está relacionada con el calendario gregoriano. Puede representar una de las siguientes opciones:
- Una fecha completa con valores de año, mes y día que no sean cero
- Un mes y un día con un año cero (p.ej., un aniversario)
- Un año solo, con un mes cero y un día cero
- Un año y un mes con un día en cero (p.ej., una fecha de vencimiento de una tarjeta de crédito)
Tipos relacionados: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
Representación JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Campos | |
---|---|
year |
Año de la fecha. Debe ser entre 1 y 9,999, o bien 0 para especificar una fecha sin año. |
month |
Mes del año. Debe ser del 1 al 12 o 0 para especificar un año sin un mes ni un día. |
day |
Día del mes. Debe ser entre 1 y 31 y ser válido para el año y el mes o bien 0 para especificar un año solo o un año y un mes en los que el día no sea significativo. |