Method: phones.getCapabilities

Mendapatkan kemampuan terkait RCS for Business dari pengguna.

Payload yang ditampilkan menentukan apakah pengguna dapat dihubungi dengan RCS untuk Bisnis dan, jika ya, fitur RCS untuk Bisnis mana yang didukung pengguna.

Penanganan error: Error 404 NOT_FOUND ditampilkan saat pengguna tidak dapat dihubungi dengan RCS untuk Bisnis. Hal ini mencakup beberapa skenario: (1) Perangkat pengguna tidak mendukung RCS atau telah menonaktifkan RCS. (2) Pengguna berada di jaringan seluler tempat agen tidak diluncurkan atau tempat traffic RCS tidak diaktifkan. (3) Agen yang belum diluncurkan meminta kemampuan pengguna yang bukan penguji.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
name

string

Kolom ini diselesaikan 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 dalam https://tools.ietf.org/html/rfc4122. Jika ID permintaan cocok dengan ID yang digunakan agen untuk permintaan sebelumnya, platform RCS untuk Bisnis 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)
  ],
  "carrier": string
}
Kolom
features[]

enum (Feature)

Daftar fitur RCS untuk Bisnis yang didukung perangkat ini.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.

Fitur

Jenis fitur RCS untuk Bisnis yang didukung pengguna.

Enum
FEATURE_UNSPECIFIED Tidak ditentukan.
RICHCARD_STANDALONE Kartu informasi mandiri.
ACTION_CREATE_CALENDAR_EVENT Tindakan yang disarankan untuk membuat acara kalender.
ACTION_DIAL Tindakan yang disarankan 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 Saran tindakan untuk melihat lokasi di aplikasi peta.
ACTION_OPEN_URL_IN_WEBVIEW Tindakan yang disarankan untuk membuka URL di webview.