Q&A API가 출시되었습니다. 이전 작업이 필요하며, 지원 중단된 엔드포인트와 관련된 자세한 내용은 지원 중단 일정을 참고하세요.
Notifications API v1.1이 출시되었습니다. 자세한 내용은 변경 로그를 참고하세요. Google 메일링 리스트에 가입하면 업데이트 사항을 이메일로 받아볼 수 있습니다.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Package google.mybusiness.businesscalls.v1

색인

BusinessCallsService(인터페이스)
AggregateMetrics(메시지)
BusinessCallsInsights(메시지)
BusinessCallsSettings(메시지)
BusinessCallsSettings.CallsState(열거형)
ErrorCode(열거형)
GetBusinessCallsSettingsRequest(메시지)
HourlyMetrics(메시지)
ListBusinessCallsInsightsRequest(메시지)
ListBusinessCallsInsightsResponse(메시지)
MetricType(열거형)
UpdateBusinessCallsSettingsRequest(메시지)
WeekDayMetrics(메시지)

BusinessCallsService

이 API를 사용하면 비즈니스 통화를 관리하고 위치에 걸려 온 부재중 전화 수와 같은 통계를 수집할 수 있습니다. 비즈니스 통화에 대한 자세한 내용은 다음 페이지를 참고하세요. https://support.google.com/business/answer/9688285?p=call_history

Google 비즈니스 프로필이 Google Ads 계정에 연결되어 있고 통화 기록이 사용 설정된 경우, 특정 시간보다 오래 지속되고 광고 상호작용으로 인해 발생한 통화는 연결된 Google Ads 계정의 '광고에서 연결된 통화' 전환에 표시됩니다. 스마트 자동 입찰과 통화 전환이 최적화 전략에 사용되면 광고비 지출액이 달라질 수 있습니다. 스마트 자동 입찰에 대해 자세히 알아보세요.'

특정 위치의 통화를 확인하고 작업을 수행하려면 해당 위치의 OWNER, CO_OWNER 또는 MANAGER여야 합니다.

GetBusinessCallsSettings

GetBusinessCallsSettings
`rpc GetBusinessCallsSettings(GetBusinessCallsSettingsRequest) returns (BusinessCallsSettings)` 지정된 위치의 비즈니스 통화 설정 리소스를 반환합니다. 승인 범위 다음 OAuth 범위가 필요합니다. `https://www.googleapis.com/auth/business.manage` 자세한 내용은 OAuth 2.0 개요를 참고하세요.

rpc GetBusinessCallsSettings(GetBusinessCallsSettingsRequest) returns (BusinessCallsSettings)

지정된 위치의 비즈니스 통화 설정 리소스를 반환합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ListBusinessCallsInsights

ListBusinessCallsInsights
`rpc ListBusinessCallsInsights(ListBusinessCallsInsightsRequest) returns (ListBusinessCallsInsightsResponse)` 위치의 비즈니스 통화 통계를 반환합니다. 승인 범위 다음 OAuth 범위가 필요합니다. `https://www.googleapis.com/auth/business.manage` 자세한 내용은 OAuth 2.0 개요를 참고하세요.

rpc ListBusinessCallsInsights(ListBusinessCallsInsightsRequest) returns (ListBusinessCallsInsightsResponse)

위치의 비즈니스 통화 통계를 반환합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 OAuth 2.0 개요를 참고하세요.

UpdateBusinessCallsSettings

UpdateBusinessCallsSettings
`rpc UpdateBusinessCallsSettings(UpdateBusinessCallsSettingsRequest) returns (BusinessCallsSettings)` 지정된 위치의 비즈니스 통화 설정을 업데이트합니다. 승인 범위 다음 OAuth 범위가 필요합니다. `https://www.googleapis.com/auth/business.manage` 자세한 내용은 OAuth 2.0 개요를 참고하세요.

rpc UpdateBusinessCallsSettings(UpdateBusinessCallsSettingsRequest) returns (BusinessCallsSettings)

지정된 위치의 비즈니스 통화 설정을 업데이트합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

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

자세한 내용은 OAuth 2.0 개요를 참고하세요.

AggregateMetrics

입력 기간 동안 집계된 측정항목입니다.

필드
`missed_calls_count`	`Int32Value` 총 부재중 전화 수입니다.
`answered_calls_count`	`Int32Value` 응답한 총 통화 수입니다.
`hourly_metrics[]`	`HourlyMetrics` 시간별 측정항목 목록입니다.
`weekday_metrics[]`	`WeekDayMetrics` 요일별 측정항목 목록입니다.
`start_date`	`Date` 이 측정항목의 날짜입니다. 측정항목이 월별인 경우 연도와 월만 사용됩니다.
`end_date`	`Date` 이 측정항목의 종료일입니다.

BusinessCallsInsights

특정 위치로 걸려온 전화에 대한 통계입니다.

필드

필드
`name`	`string` 필수 항목입니다. 통화 통계의 리소스 이름입니다. 형식: locations/{location}/businesscallsinsights
`metric_type`	`MetricType` 값이 적용되는 측정항목입니다.
`aggregate_metrics`	`AggregateMetrics` start_date 및 end_date를 기준으로 한 기간의 측정항목입니다.

name

string

필수 항목입니다. 통화 통계의 리소스 이름입니다. 형식: locations/{location}/businesscallsinsights

metric_type

MetricType

값이 적용되는 측정항목입니다.

aggregate_metrics

AggregateMetrics

start_date 및 end_date를 기준으로 한 기간의 측정항목입니다.

BusinessCallsSettings

위치의 비즈니스 통화 설정입니다.

필드

필드
`name`	`string` 필수 항목입니다. 통화 설정의 리소스 이름입니다. 형식: locations/{location}/businesscallssettings
`calls_state`	`CallsState` 필수 항목입니다. 비즈니스 통화에서 이 위치의 등록 상태입니다.
`consent_time`	`Timestamp` 입력 전용. 최종 사용자가 API 사용자에게 비즈니스 통화를 사용 설정하는 데 동의한 시간입니다.

name

string

필수 항목입니다. 통화 설정의 리소스 이름입니다. 형식: locations/{location}/businesscallssettings

calls_state

CallsState

필수 항목입니다. 비즈니스 통화에서 이 위치의 등록 상태입니다.

consent_time

Timestamp

입력 전용. 최종 사용자가 API 사용자에게 비즈니스 통화를 사용 설정하는 데 동의한 시간입니다.

CallsState

비즈니스 통화에서 위치의 가능한 상태입니다. 상태는 ENABLED 또는 DISABLED로만 업데이트할 수 있습니다. 그 외의 경우에는 PRECONDITION_FAILED 오류가 반환됩니다.

열거형
`CALLS_STATE_UNSPECIFIED`	지정되지 않았습니다.
`ENABLED`	위치에 비즈니스 통화가 사용 설정되어 있습니다.
`DISABLED`	해당 위치에서 비즈니스 전화가 사용 중지되었습니다.

ErrorCode

내부 실패에 대한 오류 코드입니다.

열거형
`ERROR_CODE_UNSPECIFIED`	지정되지 않은 오류 코드입니다.
`ERROR_CODE_UNVERIFIED_LOCATION`	위치가 인증되지 않았습니다.
`ERROR_CODE_CALLS_NOT_ENABLED`	위치에 대한 비즈니스 통화 상태가 사용 설정되지 않았습니다.
`ERROR_CODE_NOT_ELIGIBLE_LOCATION`	비즈니스 통화를 사용할 수 없는 위치입니다.

GetBusinessCallsSettingsRequest

GetBusinessCallsSettings 요청 메시지입니다.

필드

필드
`name`	`string` 필수 항목입니다. 가져올 BusinessCallsSettings입니다. `name` 필드는 가져올 비즈니스 통화 설정을 식별하는 데 사용됩니다. 형식: locations/{location_id}/businesscallssettings.

name

string

필수 항목입니다. 가져올 BusinessCallsSettings입니다.

name 필드는 가져올 비즈니스 통화 설정을 식별하는 데 사용됩니다. 형식: locations/{location_id}/businesscallssettings.

HourlyMetrics

1시간 동안의 측정항목입니다.

필드

필드
`hour`	`Int32Value` 시간대입니다. 허용되는 값은 0~23입니다.
`missed_calls_count`	`Int32Value` 이 시간 동안 발생한 총 부재중 전화 수입니다.

hour

Int32Value

시간대입니다. 허용되는 값은 0~23입니다.

missed_calls_count

Int32Value

이 시간 동안 발생한 총 부재중 전화 수입니다.

ListBusinessCallsInsightsRequest

ListBusinessCallsInsights 요청 메시지입니다.

필드
`parent`	`string` 필수 항목입니다. 통화 통계를 가져올 상위 위치입니다. 형식: locations/{location_id}
`page_size`	`int32` 선택사항입니다. 반환할 BusinessCallsInsights의 최대 개수입니다. 지정하지 않으면 최대 20이 반환됩니다. 일부 metric_types(예: AGGREGATE_COUNT)는 단일 페이지를 반환합니다. 이러한 측정항목의 경우 page_size는 무시됩니다.
`page_token`	`string` 선택사항입니다. 이전 `ListBusinessCallsInsights` 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다. 페이지를 매길 때 `ListBusinessCallsInsights`에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다. 일부 metric_types (예: AGGREGATE_COUNT)는 단일 페이지를 반환합니다. 이러한 측정항목의 경우 pake_token은 무시됩니다.
`filter`	`string` 선택사항입니다. 반환할 통화 통계를 제한하는 필터입니다. 응답에는 필터와 일치하는 항목만 포함됩니다. MetricType을 제공하지 않으면 AGGREGATE_COUNT가 반환됩니다. end_date를 지정하지 않으면 데이터를 사용할 수 있는 마지막 날짜가 사용됩니다. start_date를 지정하지 않으면 데이터가 제공되는 첫 번째 날짜(현재 6개월)로 기본 설정됩니다. start_date가 데이터를 사용할 수 있는 날짜보다 이전이면 데이터가 사용 가능한 날짜부터 반환됩니다. 현재 다음 필터가 지원됩니다. 1. start_date="DATE", 여기서 날짜는 YYYY-MM-DD 형식입니다. 2. end_date="DATE", 여기서 날짜는 YYYY-MM-DD 형식입니다. 3. metric_type=XYZ이며, 여기서 XYZ는 유효한 MetricType입니다. 4. 위 항목 모두의 접속사(AND)입니다. 예: "start_date=2021-08-01 AND end_date=2021-08-10 AND metric_type=AGGREGATE_COUNT" AGGREGATE_COUNT metric_type은 날짜의 DD 부분을 무시합니다.

ListBusinessCallsInsightsResponse

ListBusinessCallsInsights의 응답 메시지입니다.

필드

필드
`business_calls_insights[]`	`BusinessCallsInsights` 위치에 대한 비즈니스 통화 통계 모음입니다.
`next_page_token`	`string` 다음 페이지를 검색하기 위해 `page_token`으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다. 일부 metric_types (예: AGGREGATE_COUNT)는 단일 페이지를 반환합니다. 이러한 측정항목의 경우 next_page_token이 비어 있습니다.

business_calls_insights[]

BusinessCallsInsights

위치에 대한 비즈니스 통화 통계 모음입니다.

next_page_token

string

다음 페이지를 검색하기 위해 page_token으로 전송할 수 있는 토큰입니다. 이 필드를 생략하면 후속 페이지가 표시되지 않습니다. 일부 metric_types (예: AGGREGATE_COUNT)는 단일 페이지를 반환합니다. 이러한 측정항목의 경우 next_page_token이 비어 있습니다.

MetricType

측정항목의 유형입니다.

열거형
`METRIC_TYPE_UNSPECIFIED`	측정항목 유형이 지정되지 않았습니다.
`AGGREGATE_COUNT`	제공된 측정항목은 입력 time_range에 대해 집계된 수입니다.

UpdateBusinessCallsSettingsRequest

UpdateBusinessCallsSettings 요청 메시지입니다.

필드

필드
`business_calls_settings`	`BusinessCallsSettings` 필수 항목입니다. 업데이트할 BusinessCallsSettings입니다. `name` 필드는 업데이트할 비즈니스 통화 설정을 식별하는 데 사용됩니다. 형식: locations/{location_id}/businesscallssettings
`update_mask`	`FieldMask` 필수 항목입니다. 업데이트할 필드 목록입니다.

business_calls_settings

BusinessCallsSettings

필수 항목입니다. 업데이트할 BusinessCallsSettings입니다.

name 필드는 업데이트할 비즈니스 통화 설정을 식별하는 데 사용됩니다. 형식: locations/{location_id}/businesscallssettings

update_mask

FieldMask

필수 항목입니다. 업데이트할 필드 목록입니다.

WeekDayMetrics

요일의 측정항목입니다.

필드

필드
`day`	`DayOfWeek` 요일입니다. 허용되는 값은 일요일~토요일입니다.
`missed_calls_count`	`Int32Value` 이 시간 동안 발생한 총 부재중 전화 수입니다.

day

DayOfWeek

요일입니다. 허용되는 값은 일요일~토요일입니다.

missed_calls_count

Int32Value

이 시간 동안 발생한 총 부재중 전화 수입니다.