Method: phones.getCapabilities

Mendapatkan kemampuan terkait RBM dari pengguna.

Payload yang ditampilkan menentukan apakah pengguna dapat dijangkau dengan RBM dan, jika demikian, fitur RBM mana yang didukung pengguna. Jika pengguna tidak dapat dihubungi dengan RBM, platform RBM akan menampilkan 404 NOT_FOUND.

Agen yang tidak diluncurkan hanya dapat meminta kemampuan untuk pengguna yang merupakan penguji agen tersebut. Jika agen yang belum diluncurkan meminta kemampuan non-penguji, platform RBM akan menampilkan 403 PERMISSION_DENIED.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Kolom ini di-resolve ke "phones/{E.164}/capabilities", dengan {E.164} adalah nomor telepon pengguna dalam format E.164. Misalnya, untuk pengguna dengan nomor telepon AS +1-222-333-4444, endpoint yang dihasilkan adalah https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities.

Parameter kueri

Parameter
requestId

string

ID unik permintaan, yang ditetapkan oleh agen. Ini harus berupa UUID, seperti yang ditentukan di https://tools.ietf.org/html/rfc4122. Jika ID permintaan cocok dengan ID yang digunakan agen untuk permintaan sebelumnya, platform RBM akan mengabaikan permintaan baru.
agentId

string

Wajib. ID unik agen.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Daftar fitur yang didukung oleh pengguna

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "features": [
    enum (Feature)
  ]
}
Kolom
features[]

enum (Feature)

Daftar fitur RBM yang didukung perangkat ini.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

Fitur

Jenis fitur RBM yang didukung pengguna.

Enum
FEATURE_UNSPECIFIED Tidak ditentukan.
REVOCATION Pencabutan. Jika pengguna mendukung pencabutan, agen dapat mencabut pesan yang dikirim sebelum platform RBM mengirimkan pesan tersebut.
RICHCARD_STANDALONE Kartu informasi mandiri.
ACTION_CREATE_CALENDAR_EVENT Tindakan yang disarankan untuk membuat acara kalender.
ACTION_DIAL Saran tindakan untuk menghubungi nomor.
ACTION_OPEN_URL Tindakan yang disarankan untuk membuka URL di browser.
ACTION_SHARE_LOCATION Tindakan yang disarankan untuk membagikan lokasi.
ACTION_VIEW_LOCATION Tindakan yang disarankan untuk melihat lokasi di aplikasi peta.
ACTION_OPEN_URL_IN_WEBVIEW Tindakan yang disarankan untuk membuka URL di webview.
ACTION_COMPOSE Tindakan yang disarankan untuk menulis pesan teks/audio/video.