Method: users.batchGet

Bir kullanıcı listesi için RCS özellikli telefon numaralarını alır.

Döndürülen yük, belirtilen kullanıcılar için RBM platformu tarafından erişilebilen RCS özellikli telefon numaralarının listesini içerir. Yalnızca temsilcinin başlatıldığı bir operatör için RCS'nin etkin olduğu telefon numaraları döndürülür.

Döndürülen yük, aracının başlatma durumundan bağımsız olarak bir telefon numarası listesinin potansiyel erişimini tahmin etmek için kullanılabilecek değerleri de içerir.

Dakikada maksimum 600 sorgu (QPM).

HTTP isteği

POST https://rcsbusinessmessaging.googleapis.com/v1/users:batchGet

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

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "users": [
    string
  ],
  "agentId": string
}
Alanlar
users[]

string

Kullanıcıların telefon numaralarının E.164 biçimindeki listesi.
agentId

string

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

Yanıt gövdesi

RBM erişilebilirlik kullanıcı verileriyle yanıt verme.

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

JSON gösterimi 
{
  "reachableUsers": [
    string
  ],
  "totalRandomSampleUserCount": integer,
  "reachableRandomSampleUserCount": integer
}
Alanlar
reachableUsers[]

string

RBM'nin erişebileceği kullanıcı telefon numaralarının listesi. Yalnızca temsilcinin başlatıldığı operatörlerdeki kullanıcıları içerir.
totalRandomSampleUserCount

integer

reachableUsers içinden rastgele seçilen telefon numaralarının sayısı. Genellikle bu değer, istenen toplam telefon numaralarının yaklaşık% 75'idir. İstenen telefon numaralarının sayısı 500'den azsa bu değer 0 olur.
reachableRandomSampleUserCount

integer

Temsilcinin başlatma durumundan bağımsız olarak, rastgele seçilmiş listeden tüm operatörlerde RCS'ye ulaşılabilen telefon numaralarının sayısı. Bu değer ile totalRandomSampleUserCount arasındaki oran, bir kullanıcı listesinin potansiyel erişimini yaklaşık olarak belirleyebilir.

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.