Method: locations.businesscallsinsights.list

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

HTTP 요청

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

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

경로 매개변수

매개변수
parent

string

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

쿼리 매개변수

매개변수
pageSize

integer

선택사항입니다. 반환할 BusinessCallsInsights의 최대 개수입니다. 지정하지 않으면 최대 20이 반환됩니다. 일부 metric_types(예: 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 제공된 측정항목은 입력 time_range에 대해 집계된 수입니다.

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이어야 합니다.