মিডিয়া আপলোড ফিচারটি আপনাকে এমন ডেটা সংরক্ষণ করতে দেয় যা আপনি ডিসপ্লে অ্যান্ড ভিডিও ৩৬০-এ ব্যবহার করতে পারবেন। যে ধরনের ডেটা আপলোড করা যেতে পারে তার মধ্যে রয়েছে ছবি, ভিডিও, জিপ ফাইল ইত্যাদি।
আপলোড বিকল্পগুলি
ডিসপ্লে অ্যান্ড ভিডিও ৩৬০ এপিআই আপনাকে নির্দিষ্ট ধরনের বাইনারি ডেটা বা মিডিয়া আপলোড করার সুযোগ দেয়। মিডিয়া আপলোডের প্রয়োজন হয় এমন যেকোনো কাজের জন্য, আপনি যে ডেটা আপলোড করতে পারবেন তার বৈশিষ্ট্যগুলো ডেভেলপার গাইডে বিস্তারিতভাবে বর্ণনা করা আছে:
- সর্বোচ্চ আপলোড ফাইলের আকার : এই পদ্ধতিতে আপনি সর্বোচ্চ যে পরিমাণ ডেটা সংরক্ষণ করতে পারবেন।
- অনুমোদিত মিডিয়া MIME টাইপসমূহ : যে ধরনের বাইনারি ডেটা আপনি এই পদ্ধতি ব্যবহার করে সংরক্ষণ করতে পারেন।
আপনি নিম্নলিখিত যেকোনো উপায়ে আপলোড অনুরোধ করতে পারেন। uploadType প্যারামিটারের মাধ্যমে আপনার ব্যবহৃত পদ্ধতিটি নির্দিষ্ট করুন।
- সাধারণ আপলোড :
uploadType=media। প্রায় ৫ মেগাবাইট বা তার কম আকারের ফাইল দ্রুত স্থানান্তরের জন্য। - মাল্টিপার্ট আপলোড :
uploadType=multipart। ফাইল এবং প্রাসঙ্গিক মেটাডেটার দ্রুত স্থানান্তরের জন্য। এটি একটিমাত্র অনুরোধের মাধ্যমে ফাইল এবং মেটাডেটা স্থানান্তর করে।
মিডিয়া আপলোড করার সময় আপনি একটি /upload URI ব্যবহার করেন। মূল মিডিয়া ডেটা স্থানান্তর করার সময়ও এই URI-টি ব্যবহার করুন।
উদাহরণ:
POST /upload/media/resource-name
সহজ আপলোড
একটি ফাইল আপলোড করার জন্য সিম্পল আপলোড রিকোয়েস্ট হলো সবচেয়ে সহজ পদ্ধতি। এটি একটি ভালো বিকল্প যখন:
- ফাইলটি এতটাই ছোট যে প্রয়োজনে পুনরায় আপলোড করা যাবে।
- পাঠানোর জন্য কোনো মেটাডেটা নেই। যদি মেটাডেটার প্রয়োজন না হয় অথবা তা অনুরোধের অন্য কোথাও অন্তর্ভুক্ত থাকে, তবে এটি সত্য হতে পারে।
সাধারণ আপলোড ব্যবহার করতে, মেথডটির /upload URI-তে একটি POST বা PUT রিকোয়েস্ট পাঠান এবং uploadType=media কোয়েরি প্যারামিটারটি যোগ করুন। উদাহরণস্বরূপ:
POST https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media
সাধারণ আপলোড করার সময় যে HTTP হেডারগুলো ব্যবহার করতে হয়, সেগুলো হলো:
-
Content-Type. মেথডটির স্বীকৃত মিডিয়া ডেটা টাইপগুলোর মধ্যে একটিতে সেট করা হয়। -
Content-Length. আপনি যে পরিমাণ বাইট আপলোড করছেন, সেই সংখ্যায় সেট করুন। যদি আপনি chunked transfer encoding ব্যবহার করেন, তবে এর প্রয়োজন নেই।
মাল্টিপার্ট আপলোড
আপলোড করার ডেটার সাথে যদি আপনার মেটাডেটা পাঠানোর থাকে, তাহলে আপনি একটি multipart/related রিকোয়েস্ট করতে পারেন। আপনি যে ডেটা পাঠাচ্ছেন তা যদি এতই ছোট হয় যে প্রয়োজনে তা আবার আপলোড করা যাবে, তবে এটি একটি ভালো উপায়।
মাল্টিপার্ট আপলোড ব্যবহার করতে, মেথডটির /upload URI-তে একটি POST বা PUT রিকোয়েস্ট পাঠান এবং uploadType=multipart কোয়েরি প্যারামিটারটি যোগ করুন। উদাহরণস্বরূপ:
POST https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart
মাল্টিপার্ট আপলোড অনুরোধ করার সময় ব্যবহার করার জন্য শীর্ষ-স্তরের HTTP হেডারগুলো হলো:
-
Content-Typeকেmultipart/relatedএ সেট করুন এবং রিকোয়েস্টের অংশগুলো শনাক্ত করতে ব্যবহৃত বাউন্ডারি স্ট্রিংটি অন্তর্ভুক্ত করুন। -
Content-Length. অনুরোধের মূল অংশে থাকা মোট বাইট সংখ্যায় সেট করুন। অনুরোধের মিডিয়া অংশ অবশ্যই এই পদ্ধতির জন্য নির্দিষ্ট করা সর্বোচ্চ ফাইলের আকারের চেয়ে কম হতে হবে।
অনুরোধের মূল অংশটি একটি multipart/related কন্টেন্ট টাইপ [ RFC2387 ] হিসেবে ফরম্যাট করা হয় এবং এতে ঠিক দুটি অংশ থাকে। অংশ দুটি একটি বাউন্ডারি স্ট্রিং দ্বারা চিহ্নিত করা হয়, এবং চূড়ান্ত বাউন্ডারি স্ট্রিংটির পরে দুটি হাইফেন থাকে।
মাল্টিপার্ট রিকোয়েস্টের প্রতিটি অংশের জন্য একটি অতিরিক্ত Content-Type হেডার প্রয়োজন:
- মেটাডেটা অংশ : এটি অবশ্যই প্রথমে আসতে হবে এবং
Content-Typeঅবশ্যই স্বীকৃত মেটাডেটা ফরম্যাটগুলোর কোনো একটির সাথে মিলতে হবে। - মিডিয়া অংশ : এটি অবশ্যই দ্বিতীয় স্থানে আসতে হবে এবং
Content-Typeঅবশ্যই মেথডটির স্বীকৃত মিডিয়া MIME টাইপগুলোর কোনো একটির সাথে মিলতে হবে।
উদাহরণ
বিভিন্ন কাজ করার জন্য আপনি Display & Video 360 API ব্যবহার করে মিডিয়া আপলোড করেন। এই বিভাগে কার্ল (curl) অনুরোধ হিসেবে উদাহরণ দেওয়া হয়েছে।
সৃজনশীল সম্পদ আপলোড করুন
ক্রিয়েটিভ অ্যাসেট আপলোড করার পদ্ধতি নিচে দেওয়া হলো:
curl --request POST \
'https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart' \
--header 'Authorization: Bearer access-token' \
-F "data={\"filename\": \"asset-filename\"};type=application/json;charset=UTF-8" \
-F "file=@asset-path;type=asset-mime-type"আরও বিস্তারিত তথ্য এবং কোডের উদাহরণের জন্য ক্রিয়েটিভ অ্যাসেট আপলোড করার নির্দেশিকাটি দেখুন।
কাস্টম বিডিং স্ক্রিপ্ট ফাইল আপলোড করুন
স্ক্রিপ্ট ফাইল আপলোড করার পদ্ধতি নিচে দেওয়া হলো:
curl --request POST \
'https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media' \
-H 'authorization: Bearer access-token' \
-H 'Content-Type: text/plain' \
--data-binary @script-pathআরও বিস্তারিত তথ্য এবং কোডের উদাহরণের জন্য আপলোড স্ক্রিপ্ট নির্দেশিকা দেখুন।