Method: phones.getCapabilities

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

Döndürülen yük, bir kullanıcıya RBM ile ulaşılıp ulaşılamayacağını ve ulaşılabiliyorsa kullanıcının hangi RBM özelliklerini desteklediğini belirtir. RBM ile kullanıcıya ulaşılamazsa RBM platformu 404 NOT_FOUND değerini döndürür.

Başlatılmamış bir temsilci, yalnızca bu temsilcinin test kullanıcısı olan kullanıcılar için özellik isteğinde bulunabilir. Lansmanı yapılmamış bir temsilci, test kullanıcısı olmayan bir kullanıcının özelliklerini talep ederse RBM platformu 403 PERMISSION_DENIED değerini döndürür.

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" (telefonlar/{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 numarasına sahip bir kullanıcı için ortaya çıkan uç nokta https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/capabilities şeklindedir.

Sorgu parametreleri

Parametreler
requestId

string

İsteğin temsilci tarafından atanan benzersiz kimliği. Bu, https://tools.ietf.org/html/rfc4122'de tanımlandığı şekilde bir UUID olmalıdır. İstek kimliği, temsilcinin önceki bir istek için kullandığı bir 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'a Genel Bakış başlıklı makaleyi inceleyin.

Özellik

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

Sıralamalar
FEATURE_UNSPECIFIED Belirtilmedi.
REVOCATION İptal. Kullanıcı iptali destekliyorsa temsilci, RBM platformu mesajı teslim etmeden önce gönderdiği mesajı iptal edebilir.
RICHCARD_STANDALONE Bağımsız zengin kartlar.
ACTION_CREATE_CALENDAR_EVENT Takvim etkinliği oluşturmak için önerilen işlem.
ACTION_DIAL Bir numarayı çevirmek için önerilen işlem.
ACTION_OPEN_URL Tarayıcıda bir URL açmak için önerilen işlem.
ACTION_SHARE_LOCATION Konum paylaşmak için önerilen işlem.
ACTION_VIEW_LOCATION Bir harita uygulamasında bir konumu görüntülemek için önerilen işlem.
ACTION_OPEN_URL_IN_WEBVIEW URL'yi web görünümünde açmak için önerilen işlem.
ACTION_COMPOSE Metin/sesli/video mesaj oluşturmak için önerilen işlem.