Method: files.create

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

এজেন্ট ফাইলের URL বা বাইনারি এবং (ঐচ্ছিকভাবে) সংশ্লিষ্ট থাম্বনেল ফাইলের URL প্রদান করে।

গুরুত্বপূর্ণ: ব্যবহারকারীর গোপনীয়তা এবং নিরাপত্তার জন্য, RBM প্ল্যাটফর্ম প্রদত্ত ইউআরএল থেকে মিডিয়া এবং পিডিএফ ফাইল ব্যবহারকারীর কাছে পৌঁছে দেওয়ার আগে ডাউনলোড করে এবং প্রক্রিয়া করে। এটি অনন্য URL দ্বারা এজেন্ট ট্র্যাকিং প্রতিরোধ করে। তাই, বেশি পরিমাণে ইউনিক ইউআরএল জমা দেবেন না। RBM প্ল্যাটফর্ম এটিকে সমর্থন করে না, URLগুলি একই বা ভিন্ন ফাইলের দিকে নির্দেশ করে। অভিন্ন ফাইলের জন্য একই URL ব্যবহার করুন।

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

একটি ফাইল বাইনারি আপলোড করতে, আপলোড 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,
  "agentId": string
}
ক্ষেত্র
fileUrl

string

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

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

সমর্থিত অডিও বিষয়বস্তুর প্রকার: অডিও/aac, অডিও/mp3, অডিও/mpeg, অডিও/mpg, audio/mp4, audio/mp4-latm, audio/3gpp, application/ogg, audio/ogg।

সমর্থিত ভিডিও সামগ্রী প্রকার: 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।

agentId

string

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

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

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

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

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

string

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

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

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

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

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