Method: files.create

মিডিয়া বা রিচ কার্ড বার্তাগুলিতে ব্যবহারের জন্য একটি ফাইল আপলোড করে৷

এজেন্ট ফাইলের URL বা বাইনারি এবং (ঐচ্ছিকভাবে) সংশ্লিষ্ট থাম্বনেল ফাইলের URL প্রদান করে। RBM প্ল্যাটফর্ম 30 দিনের জন্য ফাইলটি ক্যাশ করে এবং একটি অনন্য নাম প্রদান করে যা আপনি এজেন্ট বার্তা পাঠানোর সময় ফাইলটি সনাক্ত করতে ব্যবহার করতে পারেন।

একটি ফাইল বাইনারি আপলোড করতে, আপলোড URI-তে একটি HTTP POST অনুরোধ করুন, JSON অনুরোধের বডি থেকে fileUrl ক্ষেত্রটি বাদ দিন এবং বাইনারিটিকে POST অনুরোধের বডি হিসাবে নির্দিষ্ট করুন৷ উদাহরণ স্বরূপ, বাইনারি ফাইলের সম্পূর্ণ যোগ্য ফাইল পাথ সহ --upload-file cURL পতাকা ব্যবহার করুন।

HTTP অনুরোধ

  • মিডিয়া আপলোড অনুরোধের জন্য URI আপলোড করুন:
    POST https://rcsbusinessmessaging.googleapis.com/upload/v1/files
  • মেটাডেটা URI, শুধুমাত্র মেটাডেটা অনুরোধের জন্য:
    POST https://rcsbusinessmessaging.googleapis.com/v1/files

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

শরীরের অনুরোধ

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

JSON প্রতিনিধিত্ব
{
  "fileUrl": string,
  "thumbnailUrl": string,
  "contentDescription": string,
  "agentId": string
}
ক্ষেত্র
fileUrl

string

ঐচ্ছিক। ফাইলের সর্বজনীনভাবে উপলব্ধ URL. RBM প্ল্যাটফর্ম ফাইলটি আনার সময় HTTP শিরোনামের বিষয়বস্তু-টাইপ ক্ষেত্র থেকে ফাইলের MIME প্রকার নির্ধারণ করে।

সমর্থিত ছবির বিষয়বস্তুর প্রকার: image/jpeg, image/jpg, image/gif, image/png।

সমর্থিত ভিডিও সামগ্রী প্রকার: video/h263, video/m4v, video/mp4, video/mpeg, video/mpeg4, video/webm।

thumbnailUrl

string

ঐচ্ছিক। ফাইলের সাথে সম্পর্কিত থাম্বনেইলের সর্বজনীনভাবে উপলব্ধ URL। যদি এই ক্ষেত্রটি সেট করা না থাকে, তাহলে RBM প্ল্যাটফর্ম স্বয়ংক্রিয়ভাবে ফাইল থেকে একটি থাম্বনেইল তৈরি করে। RBM প্ল্যাটফর্ম ফাইলটি আনার সময় HTTP শিরোনামের বিষয়বস্তু-টাইপ ক্ষেত্র থেকে ফাইলের MIME প্রকার নির্ধারণ করে।

সমর্থিত ছবির বিষয়বস্তুর প্রকার: image/jpeg, image/jpg, image/gif, image/png।

contentDescription

string

ঐচ্ছিক। ফাইলের বিষয়বস্তুর পাঠ্য বিবরণ। স্ক্রীন রিডাররা এই বিবরণটি ব্যবহার করে অক্ষম ব্যবহারকারীদের ফাইলটিতে কী আছে তা বুঝতে সাহায্য করে।

agentId

string

প্রয়োজন। এজেন্টের অনন্য শনাক্তকারী।

প্রতিক্রিয়া শরীর

একটি অনন্য নামের একটি ফাইল সংস্থান যা একটি এজেন্ট বার্তা পাঠানোর সময় ফাইল সনাক্ত করতে ব্যবহার করতে পারে।

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

JSON প্রতিনিধিত্ব
{
  "name": string
}
ক্ষেত্র
name

string

সার্ভার দ্বারা নির্ধারিত ফাইল রিসোর্সের অনন্য নাম, যা একটি এজেন্ট বার্তা পাঠানোর সময় ফাইল সনাক্ত করতে ব্যবহার করতে পারে। ফরম্যাট হল "files/{uid}", যেখানে {uid} একটি অনন্য আইডি।

অনুমোদনের সুযোগ

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

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

আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।