Method: locations.businesscallsinsights.list

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

HTTP 요청

GET https://mybusinessbusinesscalls.googleapis.com/v1/{parent=locations/*}/businesscallsinsights

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
parent

string

필수 항목입니다. 통화 통계를 가져올 상위 위치입니다. 형식: locations/{locationId}

쿼리 매개변수

매개변수
pageSize

integer

선택사항입니다. 반환할 BusinessCallsInsights의 최대 개수입니다. 지정하지 않으면 최대 20개가 반환됩니다. 일부 측정항목 유형(예: AGGREGATE_COUNT)은 단일 페이지를 반환합니다. 이러한 측정항목의 경우 pageSize가 무시됩니다.
pageToken

string

선택사항입니다. 이전 businesscallsinsights.list 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 businesscallsinsights.list에 제공된 다른 모든 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다. 일부 metric_types (예: AGGREGATE_COUNT)는 단일 페이지를 반환합니다. 이러한 측정항목의 경우 pake_token이 무시됩니다.
filter

string

선택사항입니다. 반환할 통화 통계를 제한하는 필터입니다. 응답에는 필터와 일치하는 항목만 포함됩니다.

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": string
}
필드
businessCallsInsights[]

object (BusinessCallsInsights)

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

string

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

승인 범위

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

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

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

BusinessCallsInsights

위치에 대한 통화 통계입니다.

JSON 표현 
{
  "name": string,
  "metricType": enum (MetricType),
  "aggregateMetrics": {
    object (AggregateMetrics)
  }
}
필드
name

string

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

enum (MetricType)

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

object (AggregateMetrics)

startDate 및 endDate를 기준으로 한 시간 범위의 측정항목입니다.

MetricType

측정항목 유형입니다.

열거형
METRIC_TYPE_UNSPECIFIED 측정항목 유형이 지정되지 않았습니다.
AGGREGATE_COUNT 제공된 측정항목은 입력 시간 범위 동안 집계된 수입니다.

AggregateMetrics

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

JSON 표현 
{
  "missedCallsCount": integer,
  "answeredCallsCount": integer,
  "hourlyMetrics": [
    {
      object (HourlyMetrics)
    }
  ],
  "weekdayMetrics": [
    {
      object (WeekDayMetrics)
    }
  ],
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
필드
missedCallsCount

integer

총 부재중 전화 수입니다.
answeredCallsCount

integer

응답한 총 통화 수입니다.
hourlyMetrics[]

object (HourlyMetrics)

시간대별 측정항목 목록입니다.
weekdayMetrics[]

object (WeekDayMetrics)

요일별 측정항목 목록입니다.
startDate

object (Date)

이 측정항목의 날짜입니다. 측정항목이 월인 경우 연도와 월만 사용됩니다.
endDate

object (Date)

이 측정항목의 종료일입니다.

HourlyMetrics

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

JSON 표현 
{
  "hour": integer,
  "missedCallsCount": integer
}
필드
hour

integer

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

integer

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

WeekDayMetrics

평일의 측정항목입니다.

JSON 표현 
{
  "day": enum (DayOfWeek),
  "missedCallsCount": integer
}
필드
day

enum (DayOfWeek)

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

integer

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

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

integer

날짜의 연도입니다. 1~9999 사이여야 하며, 연도 없이 날짜를 지정하려면 0이어야 합니다.
month

integer

연도의 월입니다. 1~12 사이여야 하며, 월과 일 없이 연도를 지정하려면 0이어야 합니다.
day

integer

월의 일입니다. 1~31 사이여야 하고 해당 연도 및 월에 유효해야 합니다. 또는 연도만 지정하거나 일이 중요하지 않아 연도와 월을 지정하려면 0이어야 합니다.