Method: users.batchGet

ব্যবহারকারীদের একটি তালিকা থেকে আরসিএস-সক্ষম ফোন নম্বরগুলো সংগ্রহ করে।

ফেরত আসা পেলোডে নির্দিষ্ট ব্যবহারকারীদের জন্য RCS for Business প্ল্যাটফর্মের মাধ্যমে পৌঁছানো যায় এমন RCS-সক্ষম ফোন নম্বরের একটি তালিকা থাকে। শুধুমাত্র সেই ফোন নম্বরগুলোই ফেরত দেওয়া হবে, যেগুলো এজেন্টটি চালু করা হয়েছে এমন কোনো ক্যারিয়ারের জন্য RCS-সক্ষম।

ফেরত আসা পেলোডে এমন কিছু মানও থাকে, যা এজেন্টের লঞ্চ স্ট্যাটাস নির্বিশেষে, ফোন নম্বরের একটি তালিকার সম্ভাব্য নাগাল অনুমান করতে ব্যবহার করা যেতে পারে।

প্রতি মিনিটে সর্বোচ্চ 600টি প্রশ্ন (QPM)।

গুরুত্বপূর্ণ: users.batchGet মেথডটি ব্যবহারের জন্য আঞ্চলিক এন্ডপয়েন্ট প্রয়োজন। অনুরোধে অবশ্যই একটিমাত্র ভৌগোলিক অঞ্চলের ফোন নম্বর থাকতে হবে। একটি অনুরোধে একাধিক অঞ্চলের ফোন নম্বর পাঠালে অথবা ভুল আঞ্চলিক এন্ডপয়েন্টে পাঠালে 400 Bad Request ত্রুটি দেখা দেবে।

আঞ্চলিক প্রান্তবিন্দু:

HTTP অনুরোধ

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

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

অনুরোধকারী শরীর

অনুরোধের মূল অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "users": [
    string
  ],
  "agentId": string
}
ক্ষেত্র
users[]

string

ই.১৬৪ ফরম্যাটে ব্যবহারকারীদের ফোন নম্বরের তালিকা।

একটি অনুরোধের সমস্ত ফোন নম্বর অবশ্যই একই ভৌগোলিক অঞ্চলের হতে হবে। একাধিক অঞ্চলের ফোন নম্বর সম্বলিত অনুরোধ অথবা ভুল আঞ্চলিক এন্ডপয়েন্টে পাঠানো অনুরোধ 400 Bad Request ত্রুটির সাথে ব্যর্থ হবে।

agentId

string

আবশ্যক। এজেন্টের অনন্য শনাক্তকারী।

প্রতিক্রিয়া সংস্থা

RCS for Business-এর জন্য ব্যবহারকারীর পৌঁছানোর ডেটা সহ প্রতিক্রিয়া।

সফল হলে, প্রতিক্রিয়া অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "reachableUsers": [
    string
  ],
  "totalRandomSampleUserCount": integer,
  "reachableRandomSampleUserCount": integer,
  "reachableUsersMap": {
    string: {
      object (ReachableUsers)
    },
    ...
  }
}
ক্ষেত্র
reachableUsers[]

string

যেসব ব্যবহারকারীর ফোন নম্বরের সাথে RCS for Business যোগাযোগ করতে পারে, তাদের তালিকা। এতে শুধুমাত্র সেইসব ক্যারিয়ারের ব্যবহারকারীরা অন্তর্ভুক্ত, যেগুলোতে এজেন্টটি চালু করা হয়েছে।

totalRandomSampleUserCount

integer

reachableUsers থেকে দৈবচয়ন পদ্ধতিতে নির্বাচিত ফোন নম্বরের সংখ্যা। সাধারণত, এই মানটি মোট অনুরোধকৃত ফোন নম্বরের প্রায় ৭৫% হয়ে থাকে। অনুরোধকৃত ফোন নম্বরের সংখ্যা ৫০০-এর কম হলে এই মানটি 0 হয়।

reachableRandomSampleUserCount

integer

এজেন্টের লঞ্চ স্ট্যাটাস নির্বিশেষে, দৈবচয়ন পদ্ধতিতে নির্বাচিত তালিকা থেকে সমস্ত ক্যারিয়ার জুড়ে RCS-এর মাধ্যমে পৌঁছানো যায় এমন ফোন নম্বরের সংখ্যা। এই মান এবং totalRandomSampleUserCount এর অনুপাত ব্যবহার করে ব্যবহারকারীদের একটি তালিকার সম্ভাব্য পৌঁছানোর মাত্রা অনুমান করা যায়।

reachableUsersMap

map (key: string, value: object ( ReachableUsers ))

শুধুমাত্র আউটপুট। ক্যারিয়ার আইডির সাথে সেই ক্যারিয়ারে যোগাযোগযোগ্য ব্যবহারকারীদের তালিকার একটি ম্যাপ। এই ফিল্ডটি শুধুমাত্র মার্কিন ফোন নম্বরের জন্য পূরণ করা হয়।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপ প্রয়োজন:

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

আরও তথ্যের জন্য, দেখুনOAuth 2.0 Overview .

পৌঁছানো যায় এমন ব্যবহারকারীরা

একটি নির্দিষ্ট ক্যারিয়ারে যোগাযোগযোগ্য ব্যবহারকারীদের তালিকা।

JSON উপস্থাপনা 
{
  "reachableUsers": [
    string
  ]
}
ক্ষেত্র
reachableUsers[]

string

একটি নির্দিষ্ট ক্যারিয়ারে যোগাযোগযোগ্য ব্যবহারকারীদের তালিকা। এই ক্ষেত্রটি শুধুমাত্র মার্কিন ফোন নম্বরের জন্য পূরণ করা হয়।