승인된 뷰를 사용하여 대화 데이터를 가져오거나, 분석을 실행하거나, 피드백 라벨을 수정할 수 있습니다. 승인된 뷰를 사용하여 대화 데이터를 수정하거나 가져오거나, 주제 모델을 학습시키거나, 스코어카드를 만들 수는 없습니다.
승인된 뷰를 선택하여 제공되는 특정 데이터 범위에 액세스합니다. 각 뷰는 서로 다른 범위를 정의할 수 있습니다. 선택한 뷰를 통해 허용된 데이터만 표시됩니다.
할당된 Identity and Access Management (IAM) 권한을 사용하려면 보기 없음을 선택합니다. 기본 상태입니다.
필수 권한 및 역할
승인된 뷰를 사용하려면 다음 IAM 권한이 필요합니다.
프로젝트 액세스 권한
관리자와 상담사가 콘솔과 상호작용하려면 프로젝트 resourcemanager.projects.get에 대한 보기 액세스 권한이 필요합니다.
roles/browser를 사용하여 관리자와 상담사에게 기본 액세스 권한을 부여합니다. 자세한 내용은 프로젝트 수준 액세스 제어 문서를 참고하세요.
승인된 뷰 권한
SetIamPolicy 메서드를 사용하여 특정 승인된 뷰에 다음 권한을 부여합니다. 자세한 내용은 승인된 보기 리소스를 참고하세요.
승인된 뷰 사용자에게는 contactcenterinsights.authorizedViews.get 권한과 액세스할 수 있는 리소스에 대한 해당 authorized 권한만 필요합니다.
승인된 대화에 대한 권한
| 권한 | 설명 |
|---|---|
contactcenterinsights.authorizedConversations.get |
승인된 뷰를 사용하여 대화를 가져옵니다. |
contactcenterinsights.authorizedConversations.list |
승인된 뷰를 사용하여 대화를 나열합니다. |
승인된 작업의 권한
| 권한 | 설명 |
|---|---|
contactcenterinsights.authorizedOperations.get |
승인된 뷰를 사용하여 작업을 가져옵니다. |
contactcenterinsights.authorizedOperations.list |
승인된 뷰를 사용하여 작업을 나열합니다. |
사전 정의된 역할
사전 정의된 다음 IAM 역할은 필요한 권한을 제공합니다.
| 역할 | 설명 |
|---|---|
roles/contactcenterinsights.authorizeEditor |
모든 승인된 Customer Experience Insights 리소스에 대한 읽기/쓰기 액세스 권한을 제공합니다. |
roles/contactcenterinsights.authorizedViewer |
모든 Customer Experience Insights 승인 리소스에 대한 전체 액세스 권한을 제공합니다. |
승인된 뷰 검색
REST
액세스할 수 있는 모든 승인된 뷰를 가져옵니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트 ID입니다.
- LOCATION: 고객 경험 통계 데이터의 위치입니다.
- AUTHORIZED_VIEW_SET_ID: 승인된 뷰 세트 또는 와일드 카드 `-`의 사용자 정의 식별자입니다.
- PAGE_SIZE: 응답에서 반환할 최대 조회수입니다. 값이 0이면 서비스에서 기본 크기를 선택합니다. 호출에서 요청한 것보다 적은 객체를 반환할 수 있습니다. 응답에 비어 있지 않은 `next_page_token` 이 있으면 사용 가능한 데이터가 더 있음을 나타냅니다.
- PAGE_TOKEN: 마지막 `SearchAuthorizedViewsResponse`에서 반환된 값입니다. 이 값은 이전 `SearchAuthorizedViews` 호출의 연속이며 시스템에서 다음 데이터 페이지를 반환해야 함을 나타냅니다.
- FILTER: 응답에 나열된 승인된 뷰를 필터링하는 필터 표현식입니다. `authorized_view_id`, `display_name`, `conversation_filter`, `create_time`, `update_time` 필드를 기준으로 필터링할 수 있습니다. 임의의 표현식을 사용할 수 있습니다. 문자열 필드에 정규 표현식을 사용할 수도 있습니다.
- 예:
display_name = "My View" - 예시:
conversation_filter =~ ".*agent-1.*" - 예시:
create_time > "2022-01-01T00:00:00Z" - 예시:
display_name =~ ".*View.*" - 예:
create_time > "2022-01-01T00:00:00Z" AND create_time <= "2022-01-02T00:00:00Z" - ORDER_BY: 응답에 나열된 승인된 뷰를 정렬하는 순서 지정 표현식입니다.
- 예:
create_time - 예:
update_time desc
HTTP 메서드 및 URL:
GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews:search?page_size=PAGE_SIZE&page_token=PAGE_TOKEN&filter=FILTER&order_by=ORDER_BY
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{
"authorizedViews": [
{
"name": "projects/my-project/locations/us-central1/authorizedViewSets/my-view-set/authorizedViews/my-view-1",
"displayName": "My First View",
"conversationFilter": "agent_id = \"agent-1\"",
"createTime": "2022-01-01T00:00:00.000000Z",
"updateTime": "2022-01-01T00:00:00.000000Z"
},
{
"name": "projects/my-project/locations/us-central1/authorizedViewSets/my-view-set/authorizedViews/my-view-2",
"displayName": "My Second View",
"conversationFilter": "agent_id = \"agent-2\"",
"createTime": "2022-01-01T00:00:00.000000Z",
"updateTime": "2022-01-01T00:00:00.000000Z"
}
],
"nextPageToken": "next-page-token"
}
승인된 대화
승인된 대화는 승인된 뷰를 사용하여 액세스할 때의 대화를 나타냅니다.
지원되는 메서드의 전체 목록은 승인된 대화 메서드 참조 문서를 참고하세요.
승인된 대화 가져오기
REST
승인된 대화를 가져오려면 contactcenterinsights.authorizedConversations.get 권한이 필요합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트 ID입니다.
- LOCATION_ID: 프로젝트의 위치
- AUTHORIZED_VIEW_SET_ID: 승인된 보기 세트의 ID입니다.
- AUTHORIZED_VIEW_ID: 승인된 뷰의 ID입니다.
- CONVERSATION_ID: 대화의 ID입니다.
HTTP 메서드 및 URL:
GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations/CONVERSATION_ID
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{
"name": "projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations/CONVERSATION_ID",
"createTime": "2025-03-03T11:23:17.823813113Z",
"updateTime": "2025-03-03T11:23:17.987216Z",
"agentId": "AGENT_ID",
"callMetadata": {
"customerChannel": 1,
"agentChannel": 2
},
"medium": "CHAT",
"duration": "0s",
"turnCount": 2,
"languageCode": "en",
"startTime": "2025-03-03T11:23:16.903361174Z",
"qualityMetadata": {
"agentInfo": [
{
"agentId": "AGENT_ID",
"agentType": "HUMAN_AGENT"
}
]
}
}
승인된 대화 목록
REST
승인된 대화를 나열하려면 contactcenterinsights.authorizedConversations.list 권한이 필요합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트 ID입니다.
- LOCATION_ID: 프로젝트의 위치입니다.
- AUTHORIZED_VIEW_SET_ID: 승인된 보기 세트의 ID입니다.
- AUTHORIZED_VIEW_ID: 승인된 뷰의 ID입니다.
- PAGE_SIZE: 페이지당 반환할 대화 수입니다.
HTTP 메서드 및 URL:
GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations?pageSize=PAGE_SIZE
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{
"conversations": [
{
"name": "projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations/4315d72e3d-c75-94d-2d5-1ae05b4222352",
"createTime": "2025-03-03T11:23:17.823813113Z",
"updateTime": "2025-03-03T11:23:17.987216Z",
"agentId": "AGENT_ID",
"callMetadata": {
"customerChannel": 1,
"agentChannel": 2
},
"medium": "CHAT",
"duration": "0s",
"turnCount": 2,
"languageCode": "en",
"startTime": "2025-03-03T11:23:16.903361174Z",
"qualityMetadata": {
"agentInfo": [
{
"agentId": "AGENT_ID",
"agentType": "AUTOMATED_AGENT"
}
]
}
},
{
"name": "projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations/8d3b61-bd4-f2c-364-b5a794f76",
"createTime": "2025-03-03T11:19:58.605217527Z",
"updateTime": "2025-03-03T11:19:58.901962Z",
"agentId": "AGENT_ID",
"callMetadata": {
"customerChannel": 1,
"agentChannel": 2
},
"medium": "CHAT",
"duration": "0s",
"turnCount": 2,
"runtimeAnnotations": [
{
"createTime": "2025-03-03T11:19:56.164686195Z",
"startBoundary": {
"transcriptIndex": 1
},
"endBoundary": {
"transcriptIndex": 2
},
"answerFeedback": {},
}
],
"languageCode": "en",
"startTime": "2025-03-03T11:19:56.164686195Z",
"qualityMetadata": {
"agentInfo": [
{
"agentId": "AGENT_ID",
"agentType": "HUMAN_AGENT"
}
]
}
}
],
"nextPageToken": "NEXT_PAGE_TOKEN"
}
승인된 작업
지원되는 메서드의 전체 목록은 승인된 작업 메서드 참조 문서를 참고하세요.
승인된 작업 가져오기
REST
승인된 작업을 가져오려면 contactcenterinsights.authorizedOperations.get 권한이 필요합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트 ID입니다.
- LOCATION: 고객 경험 통계 데이터의 위치입니다.
- OPERATION_ID: 분석하려는 대화의 ID입니다. 이 값은 분석을 만들 때 반환되었습니다.
HTTP 메서드 및 URL:
GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{
"name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.contactcenterinsights.v1.QueryMetricsMetadata"
},
"done": true
}
승인된 작업 나열
REST
승인된 작업을 나열하려면 contactcenterinsights.authorizedOperations.list 권한이 필요합니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트 ID입니다.
- LOCATION: 고객 경험 통계 데이터의 위치입니다.
- AUTHORIZED_VIEW_SET_ID: 승인된 보기 세트의 ID입니다.
- AUTHORIZED_VIEW_ID: 승인된 뷰의 ID입니다.
HTTP 메서드 및 URL:
GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/operations/
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{
"operations": [
{
"name": "projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.contactcenterinsights.v1.QueryMetricsMetadata"
},
"done": true
},
{
"name": "projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/operations/OPERATION_ID_2",
"metadata": {
"@type": "type.googleapis.com/google.cloud.contactcenterinsights.v1.QueryMetricsMetadata"
},
"done": true
}
]
}