Method: phones.getCapabilities

Bir kullanıcının RBM ile ilgili özelliklerini alın.

Döndürülen yük, kullanıcıya RBM ile ulaşılabileceğini ve ulaşılabiliyorsa kullanıcının hangi RBM özelliklerini desteklediğini belirtir.

Hata işleme: Kullanıcıya RBM ile ulaşılamadığında 404 NOT_FOUND hatası döndürülür. Bu durum, birden fazla senaryoyu kapsar: (1) Kullanıcının cihazı RCS'yi desteklemiyor veya RCS devre dışı bırakılmış. (2) Kullanıcı, temsilcinin başlatılmadığı veya RCS trafiğinin etkinleştirilmediği bir mobil ağda bulunuyor. (3) Kullanıma sunulmamış bir aracı, test kullanıcısı olmayan bir kullanıcının özelliklerini istiyor.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

Bu alan "phones/{E.164}/capabilities" olarak çözümlenir. Burada {E.164}, kullanıcının E.164 biçimindeki telefon numarasıdır. Örneğin, +1-222-333-4444 ABD telefon numarasına sahip bir kullanıcı için sonuçta elde edilen uç nokta https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities olur.

Sorgu parametreleri

Parametreler
requestId

string

Temsilci tarafından atanan isteğin benzersiz kimliği. Bu, https://tools.ietf.org/html/rfc4122 adresinde tanımlandığı gibi bir UUID olmalıdır. İstek kimliği, temsilcinin önceki bir istek için kullandığı kimlikle eşleşirse RBM platformu yeni isteği yoksayar.

agentId

string

Zorunlu. Temsilcinin benzersiz tanımlayıcısı.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Kullanıcı tarafından desteklenen özelliklerin listesi

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "features": [
    enum (Feature)
  ]
}
Alanlar
features[]

enum (Feature)

Bu cihazın desteklediği RBM özelliklerinin listesi.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview sayfasına bakın.

Özellik

Kullanıcının desteklediği RBM özellikleri türleri.

Sıralamalar
FEATURE_UNSPECIFIED Belirtilmedi.
RICHCARD_STANDALONE Bağımsız zengin kartlar.
ACTION_CREATE_CALENDAR_EVENT Takvim etkinliği oluşturmak için önerilen işlem.
ACTION_DIAL Numara çevirmek için önerilen işlem.
ACTION_OPEN_URL URL'yi tarayıcıda açmak için önerilen işlem.
ACTION_SHARE_LOCATION Konum paylaşmak için önerilen işlem.
ACTION_VIEW_LOCATION Bir konumu harita uygulamasında görüntülemek için önerilen işlem.
ACTION_OPEN_URL_IN_WEBVIEW WebView'da URL açmak için önerilen işlem.