Method: phones.getCapabilities

사용자의 RBM 관련 기능을 가져옵니다.

반환된 페이로드는 사용자에게 RBM으로 연락할 수 있는지 여부 및 도달할 수 있는 경우 사용자가 지원하는 RBM 기능을 지정합니다. RBM으로 사용자에게 연락할 수 없는 경우 RBM 플랫폼은 404 NOT_FOUND를 반환합니다.

실행되지 않은 에이전트는 해당 에이전트의 테스터인 사용자에게만 기능을 요청할 수 있습니다. 실행되지 않은 에이전트가 테스터가 아닌 사용자의 기능을 요청하면 RBM 플랫폼은 403 PERMISSION_DENIED를 반환합니다.

HTTP 요청

GET https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*}/capabilities

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

경로 매개변수

매개변수
name

string

이 필드는 'phones/{E.164}/capabilities'로 확인됩니다. 여기서 {E.164}는 E.164 형식의 사용자 전화번호입니다. 예를 들어 미국 전화번호가 +1-222-333-4444인 사용자의 경우 결과로 반환되는 엔드포인트는 https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities입니다.

쿼리 매개변수

매개변수
requestId

string

에이전트가 할당한 요청의 고유 ID입니다. https://tools.ietf.org/html/rfc4122에 정의된 대로 UUID여야 합니다. 요청 ID가 상담사가 이전 요청에 사용한 ID와 일치하면 RBM 플랫폼은 새 요청을 무시합니다.
agentId

string

필수 항목입니다. 에이전트의 고유 식별자입니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

사용자가 지원하는 기능 목록

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "features": [
    enum (Feature)
  ]
}
필드
features[]

enum (Feature)

이 기기에서 지원하는 RBM 기능 목록입니다.

승인 범위

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

  • https://www.googleapis.com/auth/rcsbusinessmessaging

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

기능

사용자가 지원하는 RBM 기능 유형

열거형
FEATURE_UNSPECIFIED 지정되지 않음
REVOCATION 해지. 사용자가 취소를 지원하는 경우 상담사는 RBM 플랫폼에서 메시지를 전달하기 전에 전송한 메시지를 취소할 수 있습니다.
RICHCARD_STANDALONE 독립형 리치 카드.
ACTION_CREATE_CALENDAR_EVENT 캘린더 일정을 만들기 위해 권장되는 작업입니다.
ACTION_DIAL 전화번호를 다이얼하는 추천 작업
ACTION_OPEN_URL 브라우저에서 URL을 여는 데 권장되는 작업입니다.
ACTION_SHARE_LOCATION 위치 공유를 제안하는 카드
ACTION_VIEW_LOCATION 지도 앱에서 위치를 보라는 제안 작업입니다.
ACTION_OPEN_URL_IN_WEBVIEW WebView에서 URL을 열 때 권장되는 작업입니다.
ACTION_COMPOSE 텍스트/오디오/동영상 메시지를 작성하는 추천 작업입니다.