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 özellikli telefon numaraları döndürülecektir.

Döndürülen yük, temsilcinin başlatma durumundan bağımsız olarak telefon numaraları listesinin potansiyel erişimini tahmin etmek için kullanılabilen değerler 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 gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

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

string

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

string

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

Yanıt gövdesi

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

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 ulaşabileceği kullanıcı telefon numaralarının listesi. Yalnızca temsilcinin başlatıldığı operatörlerdeki kullanıcıları kapsar.
totalRandomSampleUserCount

integer

reachableUsers içinden rastgele seçilen telefon numaralarının sayısı. Genellikle bu değer, istenen toplam telefon numarası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 durumuna bakılmaksızın, tüm operatörlerde RCS'den erişilebilen, rastgele seçilen listede bulunan 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'a Genel Bakış başlıklı makaleye bakın.