- HTTP 요청
- 경로 매개변수
- 쿼리 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- BusinessCallsInsights
- MetricType
- AggregateMetrics
- HourlyMetrics
- WeekDayMetrics
- DayOfWeek
- 날짜
위치의 비즈니스 통화 통계를 반환합니다.
HTTP 요청
GET https://mybusinessbusinesscalls.googleapis.com/v1/{parent=locations/*}/businesscallsinsights
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
parent |
필수 항목입니다. 통화 통계를 가져올 상위 위치입니다. 형식: locations/{locationId} |
쿼리 매개변수
매개변수 | |
---|---|
pageSize |
선택사항입니다. 반환할 BusinessCallsInsights의 최대 개수입니다. 지정하지 않으면 최대 20이 반환됩니다. 일부 metric_types(예: AGGREGATE_COUNT)는 단일 페이지를 반환합니다. 이러한 측정항목의 경우 pageSize가 무시됩니다. |
pageToken |
선택사항입니다. 이전 페이지를 매길 때 |
filter |
선택사항입니다. 반환할 통화 통계를 제한하는 필터입니다. 응답에는 필터와 일치하는 항목만 포함됩니다. MetricType을 제공하지 않으면 AGGREGATE_COUNT가 반환됩니다. endDate를 지정하지 않으면 데이터를 사용할 수 있는 마지막 날짜가 사용됩니다. startDate를 지정하지 않으면 데이터가 제공되는 첫 번째 날짜(현재 6개월)로 기본 설정됩니다. startDate가 데이터를 사용할 수 있는 날짜보다 이전이면 데이터가 사용 가능한 날짜부터 반환됩니다. 현재 다음 필터가 지원됩니다. 1. startDate="DATE" 여기서 날짜는 YYYY-MM-DD 형식입니다. 2. endDate="DATE" 여기서 날짜는 YYYY-MM-DD 형식입니다. 3. metricType=XYZ이며, 여기서 XYZ는 유효한 MetricType입니다. 4. 위 항목 모두의 접속사(AND)입니다. 예: "startDate=2021-08-01 AND endDate=2021-08-10 AND metricType=AGGREGATE_COUNT" AGGREGATE_COUNT metricType은 날짜의 DD 부분을 무시합니다. |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
businesscallsinsights.list의 응답 메시지입니다.
JSON 표현 |
---|
{
"businessCallsInsights": [
{
object ( |
필드 | |
---|---|
businessCallsInsights[] |
위치에 대한 비즈니스 통화 통계 모음입니다. |
nextPageToken |
다음 페이지를 검색하기 위해 |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/business.manage
자세한 내용은 OAuth 2.0 개요를 참고하세요.
BusinessCallsInsights
특정 위치로 걸려온 전화에 대한 통계입니다.
JSON 표현 |
---|
{ "name": string, "metricType": enum ( |
필드 | |
---|---|
name |
필수 항목입니다. 통화 통계의 리소스 이름입니다. 형식: locations/{location}/businesscallsinsights |
metricType |
값이 적용되는 측정항목입니다. |
aggregateMetrics |
startDate 및 endDate를 기준으로 한 기간의 측정항목입니다. |
MetricType
측정항목의 유형입니다.
열거형 | |
---|---|
METRIC_TYPE_UNSPECIFIED |
측정항목 유형이 지정되지 않았습니다. |
AGGREGATE_COUNT |
제공된 측정항목은 입력 time_range에 대해 집계된 수입니다. |
AggregateMetrics
입력 기간 동안 집계된 측정항목입니다.
JSON 표현 |
---|
{ "missedCallsCount": integer, "answeredCallsCount": integer, "hourlyMetrics": [ { object ( |
필드 | |
---|---|
missedCallsCount |
총 부재중 전화 수입니다. |
answeredCallsCount |
응답한 총 통화 수입니다. |
hourlyMetrics[] |
시간별 측정항목 목록입니다. |
weekdayMetrics[] |
요일별 측정항목 목록입니다. |
startDate |
이 측정항목의 날짜입니다. 측정항목이 월별인 경우 연도와 월만 사용됩니다. |
endDate |
이 측정항목의 종료일입니다. |
HourlyMetrics
1시간 동안의 측정항목입니다.
JSON 표현 |
---|
{ "hour": integer, "missedCallsCount": integer } |
필드 | |
---|---|
hour |
시간대입니다. 허용되는 값은 0~23입니다. |
missedCallsCount |
이 시간 동안 발생한 총 부재중 전화 수입니다. |
WeekDayMetrics
요일의 측정항목입니다.
JSON 표현 |
---|
{
"day": enum ( |
필드 | |
---|---|
day |
요일입니다. 허용되는 값은 일요일~토요일입니다. |
missedCallsCount |
이 시간 동안 발생한 총 부재중 전화 수입니다. |
DayOfWeek
요일을 나타냅니다.
열거형 | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
요일이 지정되지 않습니다. |
MONDAY |
월요일 |
TUESDAY |
화요일 |
WEDNESDAY |
수요일 |
THURSDAY |
목요일 |
FRIDAY |
금요일 |
SATURDAY |
토요일 |
SUNDAY |
일요일 |
날짜
생일과 같은 캘린더 날짜 전체 또는 일부를 나타냅니다. 하루 중 시간과 시간대가 다른 곳에 지정되어 있거나 중요하지 않습니다. 날짜는 그레고리력을 기준으로 합니다. 다음 중 하나를 나타낼 수 있습니다.
- 연도, 월, 일 값이 0이 아닌 전체 날짜
- 월과 일, 연도는 0년임 (예: 기념일)
- 1년만 입력(월 0일과 0일)
- 연도와 월, 0일 (예: 신용카드 만료일)
관련 유형: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
JSON 표현 |
---|
{ "year": integer, "month": integer, "day": integer } |
필드 | |
---|---|
year |
날짜의 연도입니다. 1~9999 사이의 값이어야 합니다. 연도 없이 날짜를 지정하려면 0이어야 합니다. |
month |
월입니다. 1~12 사이의 값이어야 합니다. 월과 일 없이 연도를 지정하려면 0과 같아야 합니다. |
day |
날짜입니다. 1~31 사이의 값이어야 하며 연도와 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않은 연도와 월을 지정하려면 0이어야 합니다. |