Play Games Services Publishing API-এর মাধ্যমে ছবি আপলোড করা

Play Games Services Publishing API আপনাকে গেম রিসোর্সের জন্য ছবি আপলোড করতে দেয়।

আপলোড করার বিকল্প

Play Games Services Publishing API আপনাকে নির্দিষ্ট ধরনের বাইনারি ডেটা বা মিডিয়া আপলোড করতে দেয়। আপনি যে ডেটা আপলোড করতে পারবেন তার নির্দিষ্ট বৈশিষ্ট্য মিডিয়া আপলোড কাজ করে এমন যেকোনও পদ্ধতির রেফারেন্স পৃষ্ঠায় উল্লেখ করা আছে:

  • আপলোড করা ফাইলের সর্বাধিক সাইজ: এই পদ্ধতির মাধ্যমে আপনি সর্বাধিক কত ডেটা স্টোর করতে পারবেন।

  • গ্রহণযোগ্য মিডিয়া MIME-এর ধরন: এই পদ্ধতি ব্যবহার করে আপনি যে ধরনের বাইনারি ডেটা স্টোর করতে পারবেন।

আপনি নিম্নলিখিত যেকোনও উপায়ে আপলোড করার অনুরোধ করতে পারেন। uploadType অনুরোধ প্যারামিটারের সাথে আপনি যে পদ্ধতি ব্যবহার করছেন তা নির্দিষ্ট করুন।

  • সহজ আপলোড: uploadType=media। ছোট ফাইল, যেমন ৫ এমবি বা তার কম সাইজের ফাইল দ্রুত ট্রান্সফার করার জন্য।

  • মাল্টিপার্ট আপলোড: uploadType=multipart. ছোট ফাইল ও মেটাডেটা দ্রুত ট্রান্সফার করার জন্য; মেটাডেটা সহ ফাইল ট্রান্সফার করে যা এটিকে বর্ণনা করে, সব একটি অনুরোধে।

  • আবার শুরু করা যায় এমন আপলোড: uploadType=resumable. নির্ভরযোগ্য ট্রান্সফারের জন্য, বিশেষ করে বড় ফাইলের ক্ষেত্রে গুরুত্বপূর্ণ। এই পদ্ধতিতে, আপনি একটি সেশন শুরু করার অনুরোধ ব্যবহার করেন, যার মধ্যে ঐচ্ছিকভাবে মেটাডেটা অন্তর্ভুক্ত থাকতে পারে। বেশিরভাগ অ্যাপ্লিকেশনের জন্য এটি একটি ভালো স্ট্র্যাটেজি, কারণ এটি ছোট ফাইলের ক্ষেত্রেও কাজ করে, তবে প্রতি আপলোডের জন্য একটি অতিরিক্ত HTTP অনুরোধ করতে হয়।

আপনি মিডিয়া আপলোড করার সময়, একটি বিশেষ URI ব্যবহার করেন। আসলে, যেসব পদ্ধতি মিডিয়া আপলোড সাপোর্ট করে সেগুলির দুটি URI এন্ডপয়েন্ট আছে:

  • মিডিয়ার জন্য /upload URI. আপলোড এন্ডপয়েন্টের ফর্ম্যাট হল “/upload” প্রিফিক্স সহ স্ট্যান্ডার্ড রিসোর্স URI। মিডিয়া ডেটা ট্রান্সফার করার সময় এই URI ব্যবহার করুন।

    উদাহরণ: POST /upload/games/v1configuration/images/resourceId/imageType/imageType

  • মেটাডেটার জন্য স্ট্যান্ডার্ড রিসোর্স URI. রিসোর্সে কোনও ডেটা ফিল্ড থাকলে, আপলোড করা ফাইলের বিবরণ সহ মেটাডেটা স্টোর করতে সেইসব ফিল্ড ব্যবহার করা হয়। মেটাডেটা ভ্যালু তৈরি বা আপডেট করার সময় আপনি এই URI ব্যবহার করতে পারবেন।

    উদাহরণ: POST /games/v1configuration/images/resourceId/imageType/imageType

সহজ আপলোড

ফাইল আপলোড করার সবচেয়ে সহজ পদ্ধতি হল একটি সাধারণ আপলোড অনুরোধ করা। নিম্নলিখিত বিষয়গুলির মধ্যে কোনও একটি সত্যি হলে এই বিকল্পটি বেছে নেওয়া ভালো:

  • কানেকশন কাজ না করলে, ফাইলটি এতটাই ছোট যে সম্পূর্ণ ফাইলটি আবার আপলোড করা যাবে।

  • পাঠানোর জন্য কোনও মেটাডেটা নেই। আপনি যদি আলাদা অনুরোধে এই রিসোর্সের জন্য মেটাডেটা পাঠাতে চান অথবা কোনও মেটাডেটা কাজ না করলে বা উপলভ্য না থাকলে এটি সত্যি হতে পারে। সহজ আপলোড ব্যবহার করতে, পদ্ধতির /upload URI-তে POST বা PUT অনুরোধ করুন এবং uploadType=media কোয়েরি প্যারামিটার যোগ করুন। যেমন:

POST https://www.googleapis.com/upload/games/v1configuration/images/resourceId/imageType/imageType?uploadType=media

সাধারণ আপলোড অনুরোধ করার সময় যেসব HTTP হেডার ব্যবহার করতে হবে সেগুলি হল:

  • Content-Type. প্রকাশনা API-তে উল্লেখ করা, পদ্ধতির গ্রহণযোগ্য আপলোড মিডিয়া ডেটা রেফারেন্স-এর কোনও একটিতে সেট করা আছে।

  • Content-Length. আপনি যত বাইট আপলোড করছেন সেই সংখ্যায় সেট করুন। চ্যাঙ্কড ট্রান্সফার এনকোডিং ব্যবহার করলে প্রয়োজন নেই।

উদাহরণ: সাধারণ আপলোড

নিচের উদাহরণে Play Games Services Publishing API-এর জন্য একটি সাধারণ আপলোড অনুরোধের ব্যবহার দেখানো হয়েছে।

POST /upload/games/v1configuration/images/resourceId/imageType/imageType?uploadType=media HTTP/1.1
Host: www.googleapis.com
Content-Type: image/png
Content-Length: number_of_bytes_in_file
Authorization: Bearer your_auth_token

PNG data

অনুরোধ সফল হলে, সার্ভার কোনও মেটাডেটা সহ HTTP 200 OK স্ট্যাটাস কোড ফেরত পাঠায়। যেমন:

HTTP/1.1 200
Content-Type: application/json

{
  "kind": "gamesConfiguration#imageConfiguration",
  "url": string,
  "resourceId": string,
  "imageType": string
}

মাল্টিপার্ট আপলোড

আপলোড করার জন্য ডেটার সাথে মেটাডেটা পাঠাতে চাইলে, আপনি একটি multipart/related অনুরোধ করতে পারেন। আপনি যে ডেটা পাঠাচ্ছেন সেটি যদি এত ছোট হয় যে কানেকশন ফেল করলে সেটি আবার সম্পূর্ণভাবে আপলোড করা যাবে, তাহলে এটি একটি ভালো বিকল্প।

মাল্টিপার্ট আপলোড ব্যবহার করতে, পদ্ধতির /upload URI-তে POST বা PUTঅনুরোধ করুন এবং uploadType=multipart কোয়েরি প্যারামিটার যোগ করুন। যেমন:

POST https://www.googleapis.com/upload/games/v1configuration/images/resourceId/imageType/imageType?uploadType=multipart

মাল্টিপার্ট আপলোড করার অনুরোধ করার সময় ব্যবহার করার জন্য টপ-লেভেল HTTP হেডার এর মধ্যে এগুলি অন্তর্ভুক্ত:

-Content-Type. মাল্টিপার্ট/সম্পর্কিত হিসেবে সেট করুন এবং অনুরোধের অংশ শনাক্ত করতে আপনি যে বাউন্ডারি স্ট্রিং ব্যবহার করছেন সেটি অন্তর্ভুক্ত করুন।

-Content-Length. অনুরোধের বডিতে মোট বাইটের সংখ্যায় সেট করা হয়। অনুরোধের মিডিয়া অংশটি এই পদ্ধতির জন্য নির্দিষ্ট করা সর্বাধিক ফাইল সাইজের চেয়ে কম হতে হবে।

অনুরোধের বডিটি মাল্টিপার্ট/সম্পর্কিত কন্টেন্টের ধরন RFC2387 হিসেবে ফর্ম্যাট করা হয় এবং এতে ঠিক দুটি অংশ থাকে। পার্টগুলি একটি বাউন্ডারি স্ট্রিং দ্বারা চিহ্নিত করা হয় এবং ফাইনাল বাউন্ডারি স্ট্রিংয়ের পরে দুটি হাইফেন থাকে।

মাল্টিপার্ট অনুরোধের প্রতিটি অংশের জন্য অতিরিক্ত Content-Type হেডার প্রয়োজন:

  • মেটাডেটা পার্ট: এটি প্রথমে থাকতে হবে এবং Content-Type অবশ্যই গ্রহণ করা মেটাডেটা ফর্ম্যাটের সাথে মিলতে হবে।

  • মিডিয়া পার্ট: এটি দ্বিতীয় স্থানে থাকতে হবে এবং Content-Type অবশ্যই পদ্ধতির স্বীকৃত মিডিয়া MIME ধরনের সাথে মিলতে হবে।

আপলোড করা ফাইলের জন্য প্রতিটি পদ্ধতির গ্রহণযোগ্য মিডিয়া MIME টাইপ ও সাইজ সংক্রান্ত সীমা জানতে প্রকাশনা API রেফারেন্স দেখুন।

উদাহরণ: মাল্টিপার্ট আপলোড

নিচের উদাহরণে Play Games Services Publishing API-এর জন্য মাল্টিপার্ট আপলোড অনুরোধ দেখানো হয়েছে।

POST /upload/games/v1configuration/images/resourceId/imageType/imageType?uploadType=multipart HTTP/1.1
Host: www.googleapis.com
Authorization: Bearer your_auth_token
Content-Type: multipart/related; boundary=foo_bar_baz
Content-Length: number_of_bytes_in_entire_request_body

--foo_bar_baz
Content-Type: application/json; charset=UTF-8

{
  "kind": "gamesConfiguration#imageConfiguration",
  "url": string,
  "resourceId": string,
  "imageType": string
}

--foo_bar_baz
Content-Type: image/png

PNG data
--foo_bar_baz--

অনুরোধ সফল হলে, সার্ভার কোনও মেটাডেটা সহ HTTP 200 OK স্ট্যাটাস কোড রিটার্ন করে:

HTTP/1.1 200
Content-Type: application/json

{
  "kind": "gamesConfiguration#imageConfiguration",
  "url": string,
  "resourceId": string,
  "imageType": string
}

আবার শুরু করা যায় এমন আপলোড

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

রিজিউমেবল আপলোড ব্যবহার করার ধাপগুলির মধ্যে এগুলি অন্তর্ভুক্ত:

  1. আবার শুরু করা যায় এমন সেশন শুরু করুন। আপলোড URI-তে প্রাথমিক অনুরোধ করুন যাতে মেটাডেটা অন্তর্ভুক্ত থাকে, যদি থাকে।

  2. আবার শুরু করা যায় এমন সেশনের URI সেভ করুন। প্রাথমিক অনুরোধের উত্তরে ফেরত আসা সেশন URI সেভ করুন; এই সেশনের বাকি অনুরোধের জন্য আপনি এটি ব্যবহার করবেন। ফাইল আপলোড করুন।

  3. রিজিউমেবল সেশন URI-তে মিডিয়া ফাইল পাঠান।

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

আবার শুরু করা যায় এমন সেশন শুরু করা

আবার শুরু করা যায় এমন আপলোড শুরু করতে, পদ্ধতির /upload URI-তে POST বা PUT অনুরোধ করুন এবং uploadType=resumable কোয়েরি প্যারামিটার যোগ করুন। যেমন:

POST https://www.googleapis.com/upload/games/v1configuration/images/resourceId/imageType/imageType?uploadType=resumable

এই প্রাথমিক অনুরোধের ক্ষেত্রে, বডি খালি থাকে অথবা এতে শুধুমাত্র মেটাডেটা থাকে; আপনি পরবর্তী অনুরোধে সেই ফাইলের আসল কন্টেন্ট ট্রান্সফার করবেন যেটি আপনি আপলোড করতে চান।

প্রাথমিক অনুরোধের সাথে নিম্নলিখিত HTTP হেডার ব্যবহার করুন:

  • X-Upload-Content-Type. পরবর্তী অনুরোধে ট্রান্সফার করা হবে এমন আপলোড করা ডেটার মিডিয়া MIME-এর ধরন হিসেবে সেট করা আছে।

  • X-Upload-Content-Length. পরবর্তী অনুরোধে ট্রান্সফার করা হবে এমন আপলোড ডেটার বাইটের সংখ্যায় সেট করুন। এই অনুরোধ করার সময় দৈর্ঘ্য জানা না থাকলে, আপনি এই হেডার বাদ দিতে পারেন।

  • মেটাডেটা প্রদান করলে: Content-Type. মেটাডেটার ডেটার ধরন অনুযায়ী সেট করা হয়।

  • Content-Length. এই প্রাথমিক অনুরোধের বডিতে দেওয়া বাইটের সংখ্যায় সেট করা হয়। আপনি চ্যাঙ্কড ট্রান্সফার এনকোডিং ব্যবহার করলে প্রয়োজন নেই।

আপলোড করা ফাইলের জন্য প্রতিটি পদ্ধতির অনুমোদিত মিডিয়া MIME টাইপ ও সাইজ সংক্রান্ত সীমা দেখতে, প্রকাশনা API রেফারেন্স দেখুন।

উদাহরণ: আবার শুরু করা যায় এমন সেশন শুরু করার অনুরোধ

Play Games Services Publishing API-এর জন্য কীভাবে আবার চালু করা যায় এমন সেশন শুরু করতে হয় তা নিম্নলিখিত উদাহরণে দেখানো হয়েছে।

POST /upload/games/v1configuration/images/resourceId/imageType/imageType?uploadType=resumable HTTP/1.1
Host: www.googleapis.com
Authorization: Bearer your_auth_token
Content-Length: 38
Content-Type: application/json; charset=UTF-8
X-Upload-Content-Type: image/png
X-Upload-Content-Length: 2000000

{
  "kind": "gamesConfiguration#imageConfiguration",
  "url": string,
  "resourceId": string,
  "imageType": string
}

পরের বিভাগে, কীভাবে উত্তর ম্যানেজ করতে হয় তা বর্ণনা করা হয়েছে।

আবার শুরু করা যায় এমন সেশনের URI সেভ করুন

সেশন শুরু করার অনুরোধ সফল হলে, API সার্ভার 200 OK HTTP স্ট্যাটাস কোড সহ উত্তর দেয়। এছাড়াও, এটি একটি Location হেডার প্রদান করে যা আপনার আবার শুরু করা যায় এমন সেশনের URI নির্দিষ্ট করে। নিচের উদাহরণে দেখানো Location হেডার, upload_id কোয়েরি প্যারামিটারের একটি অংশ অন্তর্ভুক্ত করে যা এই সেশনের জন্য ব্যবহার করার জন্য অনন্য আপলোড আইডি দেয়।

উদাহরণ: আবার শুরু করা যায় এমন সেশন শুরু করার উত্তর

ধাপ ১-এ করা অনুরোধের উত্তর এখানে দেওয়া হল:

HTTP/1.1 200 OK
Location: https://www.googleapis.com/upload/games/v1configuration/images/resourceId/imageType/imageType?uploadType=resumable&upload_id=xa298sd_sdlkj2
Content-Length: 0

উপরের উদাহরণ উত্তরে দেখানো Location হেডার-এর ভ্যালু হল সেশন URI যা আপনি আসল ফাইল আপলোড করার জন্য HTTP এন্ডপয়েন্ট হিসেবে ব্যবহার করবেন অথবা আপলোড স্ট্যাটাস কোয়েরি করবেন।

সেশন URI কপি করে সেভ করুন যাতে আপনি পরবর্তী অনুরোধের জন্য এটি ব্যবহার করতে পারেন।

ফাইল আপলোড করুন

ফাইল আপলোড করতে, আগের ধাপে পাওয়া আপলোড URI-তে PUT অনুরোধ পাঠান। আপলোড করার অনুরোধের ফর্ম্যাট হল:

PUT session_uri

আবার শুরু করা যায় এমন ফাইল আপলোড করার অনুরোধ করার সময় যে HTTP হেডার ব্যবহার করতে হবে তার মধ্যে এগুলি অন্তর্ভুক্ত Content-Length। এই অনুরোধে আপনি যত বাইট আপলোড করছেন, এটি সেই সংখ্যায় সেট করুন, যা সাধারণত আপলোড করা ফাইলের সাইজ হয়।

যেমন: আবার শুরু করা যায় এমন ফাইল আপলোড করার অনুরোধ

বর্তমান উদাহরণের জন্য সম্পূর্ণ ২০০০০০০ বাইট PNG ফাইল আপলোড করার জন্য এখানে একটি আবার শুরু করা যায় এমন অনুরোধ দেওয়া হল।

PUT https://www.googleapis.com/upload/games/v1configuration/images/resourceId/imageType/imageType?uploadType=resumable&upload_id=xa298sd_sdlkj2 HTTP/1.1
Content-Length: 2000000
Content-Type: image/png

bytes 0-1999999

অনুরোধ সফল হলে, সার্ভার HTTP 201 Created সহ উত্তর দেয় এবং এই রিসোর্সের সাথে যুক্ত যেকোনও মেটাডেটা পাঠায়। রিজিউমেবল সেশনের প্রাথমিক অনুরোধটি যদি কোনও PUT হয়, তাহলে কোনও আগে থেকে থাকা রিসোর্স আপডেট করার জন্য, সাফল্যের উত্তরটি হবে 200 OK, সাথে এই রিসোর্সের সাথে যুক্ত যেকোনও মেটাডেটা।

আপলোড করার অনুরোধে বাধা পড়লে অথবা আপনি সার্ভার থেকে HTTP 503 Service Unavailable বা অন্য কোনও 5xx উত্তর পেলে, বাধা পাওয়া আপলোড আবার শুরু করুন লিঙ্কে উল্লেখ করা পদ্ধতি অনুসরণ করুন।

ছোট ছোট ভাগে ফাইল আপলোড করা

আবার শুরু করা যায় এমন আপলোডের সাহায্যে, আপনি কোনও ফাইলকে একাধিক অংশে ভাগ করে প্রতিটি অংশকে পর পর আপলোড করার জন্য একাধিক অনুরোধ পাঠাতে পারবেন। এটি পছন্দসই পদ্ধতি নয় কারণ অতিরিক্ত অনুরোধের সাথে পারফর্ম্যান্সের খরচ যুক্ত থাকে এবং সাধারণত এর প্রয়োজন হয় না। তবে, যেকোনও একটি অনুরোধে ট্রান্সফার করা ডেটার পরিমাণ কমাতে আপনাকে চ্যাংকিং ব্যবহার করতে হতে পারে। এটি তখন সহায়ক হয় যখন আলাদা আলাদা অনুরোধের জন্য নির্দিষ্ট সময়সীমা থাকে, যেমন নির্দিষ্ট ধরনের Google App Engine অনুরোধের ক্ষেত্রে হয়। এছাড়াও, এটি আপনাকে এমন কাজ করতে দেয় যেমন, লিগ্যাসি ব্রাউজারগুলির জন্য আপলোড প্রগ্রেস ইঙ্গিত প্রদান করা যেগুলিতে ডিফল্ট হিসেবে আপলোড প্রগ্রেস সাপোর্ট নেই।

আপনি যদি ডেটা চ্যাঙ্ক হিসেবে আপলোড করেন, তাহলে সম্পূর্ণ ফাইল আপলোডের জন্য প্রয়োজনীয় Content-Length হেডার সহ Content-Range হেডারও প্রয়োজনীয়:

  • Content-Length. চ্যাঙ্ক সাইজ বা তার থেকে কম ভ্যালুতে সেট করুন, যেমনটি শেষ অনুরোধের ক্ষেত্রে হতে পারে।

  • Content-Range. আপনি যে ফাইল আপলোড করছেন তার কোন বাইট দেখানো হবে তা সেট করুন। যেমন, Content-Range: bytes 0-524287/2000000 থেকে বোঝা যাচ্ছে যে আপনি ২,০০০,০০০ বাইটের একটি ফাইলে প্রথম ৫২৪,২৮৮ বাইট (২৫৬ x ১০২৪ x ২) প্রদান করছেন।

বাধা পাওয়া আপলোড আবার শুরু করা

উত্তর পাওয়ার আগে আপলোড করার অনুরোধ বাতিল করা হলে অথবা আপনি সার্ভার থেকে HTTP 503 Service Unavailable উত্তর পেলে, আপনাকে অসম্পূর্ণ আপলোড আবার শুরু করতে হবে। অসম্পূর্ণ আপলোড আবার শুরু করতে, নিম্নলিখিত কাজগুলি করুন:

  1. অনুরোধের স্ট্যাটাস। আপলোড URI-তে একটি খালি PUT অনুরোধ পাঠিয়ে আপলোডের বর্তমান স্ট্যাটাস কোয়েরি করুন। এই অনুরোধের জন্য, HTTP হেডারকে Content-Range হেডার অন্তর্ভুক্ত করতে হবে যা নির্দেশ করে যে ফাইলের বর্তমান পজিশন অজানা। যেমন, আপনার মোট ফাইলের দৈর্ঘ্য ২০০০০০০ হলে, Content-Range-এর মান */2000000 হিসেবে সেট করুন। আপনি ফাইলের সম্পূর্ণ সাইজ না জানলে, Content-Range-কে */* হিসেবে সেট করুন।

  2. আপলোড করা বাইটের সংখ্যা পান। স্ট্যাটাস কোয়েরি থেকে পাওয়া উত্তর প্রসেস করা। সার্ভার তার উত্তরে Range হেডার ব্যবহার করে কোন বাইটগুলি সে এখনও পর্যন্ত পেয়েছে তা নির্দিষ্ট করে। যেমন, 0-299999-এর Range হেডার থেকে বোঝা যায় যে ফাইলের প্রথম ৩০০,০০০ বাইট পাওয়া গেছে।

  3. বাকি ডেটা আপলোড করুন। অবশেষে, আপনি যেহেতু এখন জানেন যে অনুরোধটি কোথা থেকে আবার শুরু করতে হবে, তাই বাকি ডেটা বা বর্তমান চ্যাঙ্ক পাঠান। মনে রাখবেন, আপনাকে বাকি থাকা ডেটাকে আলাদা চ্যাঙ্ক হিসেবে বিবেচনা করতে হবে, তাই আপলোড আবার শুরু করার সময় আপনাকে Content-Range হেডার পাঠাতে হবে।

উদাহরণ: কোনও বাধা পাওয়া আপলোড আবার শুরু করা

  1. আপলোড স্ট্যাটাস সম্পর্কে অনুরোধ করুন। নিম্নলিখিত অনুরোধটি Content-Range হেডার ব্যবহার করে এটি বোঝাতে চায় যে ২,০০০,০০০ বাইট ফাইলের বর্তমান পজিশন অজানা।

    PUT {session_uri} HTTP/1.1
    Content-Length: 0
    Content-Range: bytes */2000000
    
  2. উত্তর থেকে এখনও পর্যন্ত আপলোড করা বাইটের সংখ্যা এক্সট্র্যাক্ট করুন। সার্ভারের উত্তর Range হেডার ব্যবহার করে এটি বোঝায় যে এটি এখনও পর্যন্ত ফাইলের প্রথম ৪৩ বাইট পেয়েছে। কোথা থেকে আবার আপলোড শুরু করতে হবে তা নির্ধারণ করতে রেঞ্জ হেডারের উপরের ভ্যালু ব্যবহার করুন।

    HTTP/1.1 308 Resume Incomplete
    Content-Length: 0
    Range: 0-42
    
  3. যেখানে আপলোড করা বন্ধ হয়ে গিয়েছিল সেখান থেকে আবার শুরু করুন। নিম্নলিখিত অনুরোধ ফাইলটির বাকি বাইট পাঠিয়ে আপলোড করা আবার শুরু করে, যা বাইট ৪৩ থেকে শুরু হয়।

    PUT {session_uri} HTTP/1.1
    Content-Length: 1999957
    Content-Range: bytes 43-1999999/2000000
    
    bytes 43-1999999
    

সমস্যা ম্যানেজ করা

মিডিয়া আপলোড করার সময়, সমস্যা সমাধান সম্পর্কিত কিছু পেশাদার পদ্ধতি সম্পর্কে সচেতন হলে তা সহায়ক হয়।

  • কানেকশন ইন্টারাপশন বা 5xx সমস্যার কারণে আপলোড সম্পূর্ণ না হলে, আপলোড আবার শুরু করুন বা আবার চেষ্টা করুন, এর মধ্যে এগুলি অন্তর্ভুক্ত:

    • 500 Internal Server Error
    • 502 Bad Gateway
    • 503 Service Unavailable
    • 504 Gateway Timeout
  • আপলোড করার অনুরোধ আবার শুরু বা আবার চেষ্টা করার সময় কোনও 5xx সার্ভার সংক্রান্ত সমস্যা হলে এক্সপোনেনশিয়াল ব্যাকঅফ স্ট্র্যাটেজি ব্যবহার করুন। কোনও সার্ভার ওভারলোড হয়ে গেলে এই সমস্যা হতে পারে। অনুরোধের সংখ্যা বেশি হলে বা নেটওয়ার্ক ট্রাফিক বেশি থাকলে এক্সপোনেনশিয়াল ব্যাকঅফ এই ধরনের সমস্যা কমাতে সাহায্য করতে পারে।

  • অন্যান্য ধরনের অনুরোধ এক্সপোনেনশিয়াল ব্যাকঅফ দ্বারা ম্যানেজ করা উচিত নয়, তবে আপনি এখনও সেগুলির মধ্যে কিছু আবার চেষ্টা করতে পারেন। এইসব অনুরোধ আবার করার সময়, যতবার চেষ্টা করবেন তার সংখ্যা সীমিত রাখুন। যেমন, আপনার কোড সমস্যা রিপোর্ট করার আগে সর্বাধিক দশবার আবার চেষ্টা করতে পারে অথবা তার কমবার চেষ্টা করতে পারে।

  • আবার শুরু করা যায় এমন আপলোড করার সময় 404 Not Found ও 410 Gone সমস্যার সমাধান করতে পুরো আপলোড প্রসেসটি প্রথম থেকে শুরু করুন।

এক্সপোনেনশিয়াল ব্যাকঅফ

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

সঠিকভাবে ব্যবহার করা হলে, এক্সপোনেনশিয়াল ব্যাকঅফ ব্যান্ডউইথ ব্যবহারের দক্ষতা বাড়ায়, সফল উত্তর পাওয়ার জন্য প্রয়োজনীয় অনুরোধের সংখ্যা কমায় এবং কনকারেন্ট এনভায়রনমেন্টে অনুরোধের থ্রুপুট সর্বাধিক করে।

সহজ এক্সপোনেনশিয়াল ব্যাকঅফ প্রয়োগ করার ফ্লো নিচে দেওয়া হল:

  1. API-তে অনুরোধ করুন।
  2. HTTP 503 উত্তর পান, যা থেকে বোঝা যায় যে আপনাকে আবার অনুরোধ করতে হবে।
  3. ১ সেকেন্ড + random_number_milliseconds অপেক্ষা করে আবার অনুরোধ করুন।
  4. HTTP 503 উত্তর পান, যা থেকে বোঝা যায় যে আপনাকে আবার অনুরোধ করতে হবে।
  5. ২ সেকেন্ড + random_number_milliseconds অপেক্ষা করুন এবং আবার অনুরোধ করুন।
  6. HTTP 503 উত্তর পান, যা থেকে বোঝা যায় যে আপনাকে আবার অনুরোধ করতে হবে।
  7. ৪ সেকেন্ড + random_number_milliseconds অপেক্ষা করুন এবং আবার অনুরোধ করুন।
  8. HTTP 503 response কোড পান, যার অর্থ হল আপনাকে আবার অনুরোধ করতে হবে।
  9. ৮ সেকেন্ড + random_number_milliseconds অপেক্ষা করুন এবং আবার অনুরোধ করার চেষ্টা করুন।
  10. HTTP 503 response কোড পান, যার অর্থ হল আপনাকে আবার অনুরোধ করতে হবে।
  11. ১৬ সেকেন্ড + random_number_milliseconds অপেক্ষা করুন এবং আবার অনুরোধ করুন।
  12. বন্ধ করুন। সমস্যার ব্যাপারে অভিযোগ জানান বা লগ করুন।

উপরের তালিকায়, random_number_milliseconds হল ১০০০-এর সমান বা তার থেকে কম মিলি সেকেন্ডের একটি র‍্যান্ডম সংখ্যা। এটি প্রয়োজনীয়, কারণ একটি ছোট র‍্যান্ডম বিলম্ব যোগ করলে, লোড আরও সমানভাবে ডিস্ট্রিবিউট করতে এবং সার্ভার স্ট্যাম্পিড হওয়ার সম্ভাবনা এড়াতে সাহায্য করে। প্রতিটি অপেক্ষার পরে random_number_milliseconds-এর ভ্যালু আবার নির্ধারণ করতে হবে।

n-এর মান ৫ হলে অ্যালগরিদমটি বন্ধ হয়ে যাবে। এই সীমা ক্লায়েন্টকে অসীম সংখ্যক বার আবার চেষ্টা করা থেকে আটকায় এবং এর ফলে কোনও অনুরোধকে "ঠিক করা যায় না এমন সমস্যা" হিসেবে গণ্য করার আগে মোট ৩২ সেকেন্ড বিলম্ব হয়। আবার চেষ্টা করার সর্বাধিক সংখ্যা বেশি হলে কোনও অসুবিধা নেই, বিশেষ করে যদি কোনও বড় ফাইল আপলোড করা হয়; শুধু নিশ্চিত করুন যে আবার চেষ্টা করার বিলম্ব যেন যুক্তিসঙ্গত হয়, যেমন, এক মিনিটের কম।

API ক্লায়েন্ট লাইব্রেরি গাইড