Индекс
-
BusinessCallsService
(интерфейс) -
AggregateMetrics
(сообщение) -
BusinessCallsInsights
(сообщение) -
BusinessCallsSettings
(сообщение) -
BusinessCallsSettings.CallsState
(перечисление) -
ErrorCode
(перечисление) -
GetBusinessCallsSettingsRequest
(сообщение) -
HourlyMetrics
(сообщение) -
ListBusinessCallsInsightsRequest
(сообщение) -
ListBusinessCallsInsightsResponse
(сообщение) -
MetricType
(перечисление) -
UpdateBusinessCallsSettingsRequest
(сообщение) -
WeekDayMetrics
(сообщение)
БизнесЗвонкиСервис
Этот API позволяет компаниям управлять деловыми звонками и собирать такую информацию, как количество пропущенных звонков в их местоположение. Дополнительную информацию о деловых звонках можно найти на странице https://support.google.com/business/answer/9688285?p=call_history .
Если профиль компании в Google связан с аккаунтом Google Рекламы и включена история звонков, звонки, которые длятся дольше определенного времени и которые можно отнести к взаимодействию с рекламой, будут отображаться в связанном аккаунте Google Рекламы в разделе «Звонки от Конверсия рекламы. Если в стратегии оптимизации используются интеллектуальное назначение ставок и звонки-конверсии, расходы на рекламу могут измениться. Узнайте больше об интеллектуальном назначении ставок ».
Чтобы просматривать и выполнять действия по вызовам местоположения, вам необходимо быть OWNER
, CO_OWNER
или MANAGER
местоположения.
Настройки GetBusinessCalls |
---|
Возвращает ресурс настроек деловых звонков для данного местоположения.
|
ListBusinessCallsInsights |
---|
Возвращает аналитическую информацию о бизнес-вызовах местоположения.
|
Обновить настройки BusinessCalls |
---|
Обновляет настройки делового звонка для указанного местоположения.
|
Агрегатные метрики
Метрики, агрегированные за входной диапазон времени.
Поля | |
---|---|
missed_calls_count | Общее количество пропущенных звонков. |
answered_calls_count | Общее количество отвеченных вызовов. |
hourly_metrics[] | Список метрик по часам суток. |
weekday_metrics[] | Список показателей по дням недели. |
start_date | Дата для этого показателя. Если метрика является ежемесячной, используются только год и месяц. |
end_date | Дата окончания для этого показателя. |
БизнесЗвонкиАналитика
Статистика звонков, совершенных в определенное место.
Поля | |
---|---|
name | Необходимый. Имя ресурса статистики вызовов. Формат: location/{location}/businesscallsinsights. |
metric_type | Метрика, к которой применяется значение. |
aggregate_metrics | Метрика для диапазона времени на основе start_date и end_date. |
БизнесЗвонкиНастройки
Настройки деловых звонков для местоположения.
Поля | |
---|---|
name | Необходимый. Имя ресурса настроек звонков. Формат: location/{location}/businesscallssettings. |
calls_state | Необходимый. Состояние регистрации этого адреса в бизнес-звонках. |
consent_time | Только ввод. Время, когда конечный пользователь предоставил согласие пользователю API на включение бизнес-вызовов. |
Состояние звонков
Возможные состояния местоположения в деловых звонках. Состояния могут быть обновлены только до ВКЛЮЧЕНО или ВЫКЛЮЧЕНО. Все остальное вернет ошибку PRECONDITION_FAILED.
Перечисления | |
---|---|
CALLS_STATE_UNSPECIFIED | Неопределенные. |
ENABLED | Для этого местоположения включены деловые звонки. |
DISABLED | Деловые звонки отключены для данного местоположения. |
Код ошибки
Коды ошибок внутренних сбоев.
Перечисления | |
---|---|
ERROR_CODE_UNSPECIFIED | Неуказанный код ошибки. |
ERROR_CODE_UNVERIFIED_LOCATION | Местоположение не проверено. |
ERROR_CODE_CALLS_NOT_ENABLED | Состояние «Деловые звонки» для местоположения НЕ ВКЛЮЧЕНО. |
ERROR_CODE_NOT_ELIGIBLE_LOCATION | Местоположение не подходит для деловых звонков. |
GetBusinessCallsSettingsЗапрос
Сообщение запроса для GetBusinessCallsSettings.
Поля | |
---|---|
name | Необходимый. Параметры BusinessCallsSettings, которые необходимо получить. Поле |
Почасовые метрики
Показатели за час.
Поля | |
---|---|
hour | Час дня. Допустимые значения: 0–23. |
missed_calls_count | Общее количество пропущенных звонков за этот час. |
СписокБизнесЗвонкиАналитикаЗапрос
Сообщение запроса для ListBusinessCallsInsights.
Поля | |
---|---|
parent | Необходимый. Родительское местоположение, для которого требуется получить статистику вызовов. Формат: location/{location_id}. |
page_size | Необязательный. Максимальное количество возвращаемых BusinessCallsInsights. Если не указано, будет возвращено не более 20. Некоторые из metric_types (например, AGGREGATE_COUNT) возвращают одну страницу. Для этих метрик параметр page_size игнорируется. |
page_token | Необязательный. Токен страницы, полученный в результате предыдущего вызова При разбиении на страницы все остальные параметры, предоставляемые |
filter | Необязательный. Фильтр, ограничивающий возврат статистики вызовов. Ответ включает только записи, соответствующие фильтру. Если MetricType не указан, возвращается AGGREGATE_COUNT. Если end_date не указана, используется последняя дата, для которой доступны данные. Если start_date не указана, по умолчанию мы будем использовать первую дату, для которой доступны данные, которая в настоящее время составляет 6 месяцев. Если start_date предшествует дате доступности данных, данные возвращаются, начиная с даты их доступности. В настоящее время мы поддерживаем следующие фильтры. 1. start_date="ДАТА", где дата имеет формат ГГГГ-ММ-ДД. 2. end_date="ДАТА", где дата имеет формат ГГГГ-ММ-ДД. 3. metric_type=XYZ, где XYZ — допустимый тип метрики. 4. Союзы (И) всего вышеперечисленного. например, «start_date=2021-08-01 И end_date=2021-08-10 И metric_type=AGGREGATE_COUNT» Тип метрики AGGREGATE_COUNT игнорирует часть даты, состоящую из DD. |
ListBusinessCallsInsightsResponse
Ответное сообщение для ListBusinessCallsInsights.
Поля | |
---|---|
business_calls_insights[] | Коллекция бизнес-звонков с информацией о местоположении. |
next_page_token | Токен, который можно отправить как |
Тип метрики
Тип метрики.
Перечисления | |
---|---|
METRIC_TYPE_UNSPECIFIED | Тип метрики не указан. |
AGGREGATE_COUNT | Предоставленные метрики представляют собой значения, агрегированные по входному диапазону времени. |
ОбновлениеBusinessCallsНастройкиЗапрос
Сообщение запроса для UpdateBusinessCallsSettings.
Поля | |
---|---|
business_calls_settings | Необходимый. Параметры BusinessCallsSettings, которые необходимо обновить. Поле |
update_mask | Необходимый. Список полей для обновления. |
НеделяДеньМетрики
Показатели за день недели.
Поля | |
---|---|
day | День недели. Допустимые значения: воскресенье – суббота. |
missed_calls_count | Общее количество пропущенных звонков за этот час. |