Method: files.create

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

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

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

RCS for Business প্ল্যাটফর্মটি ফাইলটি 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। RCS for Business প্ল্যাটফর্ম ফাইলটি আনার সময় HTTP হেডারের কন্টেন্ট-টাইপ ফিল্ড থেকে ফাইলের MIME ধরণ নির্ধারণ করে। RCS for Business ছবি, অডিও, ভিডিও এবং PDF সমর্থন করে।

সমর্থিত ছবির কন্টেন্টের ধরণ: ছবি/জেপিইজি, ছবি/জেপিজি, ছবি/জিআইএফ, ছবি/পিএনজি।

সমর্থিত অডিও কন্টেন্টের ধরণ: অডিও/aac, অডিও/mp3, অডিও/mpeg, অডিও/mpg, অডিও/mp4, অডিও/mp4-latm, অডিও/3gpp, অ্যাপ্লিকেশন/ogg, অডিও/ogg।

সমর্থিত ভিডিও কন্টেন্টের ধরণ: video/h263, video/m4v, video/mp4, video/mpeg, video/mpeg4, video/webm।

সমর্থিত PDF কন্টেন্টের ধরণ: অ্যাপ্লিকেশন/পিডিএফ।

দ্রষ্টব্য: একটি ফাইলের URL-এ একটিই পুনঃনির্দেশ থাকতে পারে। পুনঃনির্দেশিত ফাইলের URL গুলি সর্বজনীনভাবে অ্যাক্সেসযোগ্য হতে হবে। CreateAgentMessageRequest-এ ফাইল URL গুলির জন্য পুনঃনির্দেশ সমর্থিত নয়।

thumbnailUrl

string

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

সমর্থিত ছবির কন্টেন্টের ধরণ: ছবি/জেপিইজি, ছবি/জেপিজি, ছবি/জিআইএফ, ছবি/পিএনজি।

agentId

string

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

প্রতিক্রিয়া মূল অংশ

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

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

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

string

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

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

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

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

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