new_releases 업데이트:
출시 노트에서 새로운 기능 및 제품 업데이트를 확인하세요.
Method: phones.getCapabilities
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
사용자의 RBM 관련 기능을 가져옵니다.
반환된 페이로드는 사용자가 RBM으로 연락할 수 있는지 여부와 연락할 수 있는 경우 사용자가 지원하는 RBM 기능을 지정합니다.
오류 처리: RBM으로 사용자에게 연락할 수 없는 경우 404 NOT_FOUND 오류가 반환됩니다. 여기에는 여러 시나리오가 포함됩니다. (1) 사용자의 기기가 RCS를 지원하지 않거나 RCS가 사용 중지되어 있습니다. (2) 상담사가 실행되지 않거나 RCS 트래픽이 사용 설정되지 않은 모바일 네트워크에 사용자가 있습니다. (3) 출시되지 않은 에이전트가 테스터가 아닌 사용자의 기능을 요청합니다.
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 Overview를 참조하세요.
기능
| 열거형 |
FEATURE_UNSPECIFIED |
지정되지 않음 |
RICHCARD_STANDALONE |
독립형 리치 카드 |
RICHCARD_CAROUSEL |
리치 카드 캐러셀 |
ACTION_CREATE_CALENDAR_EVENT |
캘린더 일정을 만들기 위한 추천 작업입니다. |
ACTION_DIAL |
번호를 다이얼하도록 제안된 작업입니다. |
ACTION_OPEN_URL |
브라우저에서 URL을 여는 추천 작업 |
ACTION_SHARE_LOCATION |
위치를 공유하기 위한 추천 작업입니다. |
ACTION_VIEW_LOCATION |
지도 앱에서 위치를 볼 수 있는 제안 작업입니다. |
ACTION_OPEN_URL_IN_WEBVIEW |
WebView에서 URL을 여는 추천 작업입니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-28(UTC)
[null,null,["최종 업데이트: 2025-07-28(UTC)"],[[["\u003cp\u003eThis API endpoint retrieves the RBM capabilities of a specified user, indicating whether they can be reached via RBM and which features they support.\u003c/p\u003e\n"],["\u003cp\u003eThe request is made using a GET method with the user's phone number in E.164 format as a path parameter and an agent ID and request ID as query parameters.\u003c/p\u003e\n"],["\u003cp\u003eA 404 NOT_FOUND error is returned if the user cannot be reached via RBM, which can be due to the user's device not supporting RCS, the user being on a network where the agent isn't launched, or an unlaunched agent requesting capabilities of a non-tester user.\u003c/p\u003e\n"],["\u003cp\u003eThe response body, if successful, includes a list of supported RBM features, such as rich cards, carousels, and suggested actions like opening URLs or creating calendar events.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this API requires the \u003ccode\u003ehttps://www.googleapis.com/auth/rcsbusinessmessaging\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: phones.getCapabilities\n\nGet the RBM-related capabilities of a user.\n\nThe returned payload specifies whether a user can be reached with RBM and, if so, which RBM features the user supports.\n\nError Handling: a 404 NOT_FOUND error is returned when the user cannot be reached with RBM. This includes multiple scenarios: (1) The user's device does not support RCS or has RCS disabled. (2) The user is on a mobile network where the agent is not launched or where RCS traffic is not enabled. (3) An unlaunched agent requests the capabilities of a user who is not a tester.\n\n### HTTP request\n\n`GET https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*}/capabilities`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` This field resolves to \"phones/{E.164}/capabilities\", where {E.164} is the user's phone number in E.164 format. For example, for a user with the US phone number +1-222-333-4444, the resulting endpoint is \u003chttps://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities\u003e. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requestId` | `string` The unique ID of the request, assigned by the agent. This must be a UUID, as defined in \u003chttps://tools.ietf.org/html/rfc4122\u003e. If the request ID matches an ID that the agent used for a previous request, the RBM platform ignores the new request. |\n| `agentId` | `string` Required. The agent's unique identifier. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nList of supported features by the user\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"features\": [ enum (/business-communications/rcs-business-messaging/reference/rest/v1/phones/getCapabilities#Feature) ] } ``` |\n\n| Fields ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `features[]` | `enum (`[Feature](/business-communications/rcs-business-messaging/reference/rest/v1/phones/getCapabilities#Feature)`)` List of RBM features that this device supports. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/rcsbusinessmessaging`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2).\n\nFeature\n-------\n\nTypes of RBM features that the user supports.\n\n| Enums ||\n|--------------------------------|---------------------------------------------------|\n| `FEATURE_UNSPECIFIED` | Not specified. |\n| `RICHCARD_STANDALONE` | Standalone rich cards. |\n| `RICHCARD_CAROUSEL` | Carousel of rich cards. |\n| `ACTION_CREATE_CALENDAR_EVENT` | Suggested action to create a calendar event. |\n| `ACTION_DIAL` | Suggested action to dial a number. |\n| `ACTION_OPEN_URL` | Suggested action to open a URL in browser. |\n| `ACTION_SHARE_LOCATION` | Suggested action to share a location. |\n| `ACTION_VIEW_LOCATION` | Suggested action to view a location in a map app. |\n| `ACTION_OPEN_URL_IN_WEBVIEW` | Suggested action to open a URL in webview. |"]]
