Method: phones.getCapabilities

Bir kullanıcının İşletmeler için RCS ile ilgili özelliklerini alın.

Döndürülen yük, bir kullanıcıya İş için RCS ile ulaşılıp ulaşılamayacağını ve ulaşılabiliyorsa kullanıcının hangi İş için RCS özelliklerini desteklediğini belirtir.

Hata işleme: Kullanıcıya İş için RCS 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 İş için RCS platformu yeni isteği yoksayar.

agentId

string

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

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

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)
  ],
  "carrier": string
}
Alanlar
features[]

enum (Feature)

Bu cihazın desteklediği İşletmeler için RCS ö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 İş için RCS ö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.