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 지도 앱에서 위치를 보기 위한 추천 작업입니다.