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

এই পৃষ্ঠাটি বর্ণনা করে যে কিভাবে REST প্রোটোকলের মাধ্যমে Google Photos Library API-তে পুনরায় শুরু করার যোগ্য আপলোডের অনুরোধ করা যায়। এই প্রোটোকল আপনাকে একটি আপলোড অপারেশন পুনরায় শুরু করার অনুমতি দেয় যখন যোগাযোগের ব্যর্থতা ডেটা প্রবাহে বাধা দেয়।

পুনরায় শুরুযোগ্য আপলোড বিকল্প ব্যবহার করুন যদি:

• আপনি বড় ফাইল আপলোড করছেন.
• নেটওয়ার্ক বাধা বা অন্য কিছু ট্রান্সমিশন ব্যর্থতার সম্ভাবনা বেশি (উদাহরণস্বরূপ, যদি আপনি একটি মোবাইল অ্যাপ থেকে একটি ফাইল আপলোড করছেন)।

নেটওয়ার্ক ব্যর্থতার সময় পুনরায় শুরু করা আপলোডগুলি আপনার ব্যান্ডউইথের ব্যবহার কমাতে পারে, কারণ আপনাকে শুরু থেকে বড় ফাইল আপলোডগুলি পুনরায় চালু করতে হবে না।

ধাপ 1: একটি আপলোড সেশন শুরু করা

https://photoslibrary.googleapis.com/v1/uploads এ একটি POST অনুরোধ পাঠিয়ে একটি পুনঃসূচনাযোগ্য আপলোড সেশন শুরু করুন। এই অনুরোধে ফিরে আসা পুনরায় শুরুযোগ্য আপলোড URL ব্যবহার করে, ফাইল আপলোড করুন।

POST অনুরোধে নিম্নলিখিত শিরোনামগুলি অন্তর্ভুক্ত করা আবশ্যক:

এখানে একটি POST অনুরোধ শিরোনাম আছে:

POST https://photoslibrary.googleapis.com/v1/uploads
Authorization: Bearer oauth2-token
Content-Length: 0
X-Goog-Upload-Command: start
X-Goog-Upload-Content-Type: mime-type
X-Goog-Upload-Protocol: resumable
X-Goog-Upload-Raw-Size: bytes-of-file

ধাপ 2: সেশন URL সংরক্ষণ করা হচ্ছে

সফল হলে, POST অনুরোধটি নিম্নলিখিত শিরোনাম সহ একটি 200 OK HTTP স্ট্যাটাস কোড প্রদান করে।

X-Goog-Upload-URL: url-to-make-uploads-to
X-Goog-Upload-Chunk-Granularity: chunk-granularity-in-bytes

হেডার ফিল্ড x-goog-upload-chunk-granularity ক্লায়েন্টের পাঠানো সমস্ত ডেটা খণ্ডের জন্য বাইট সারিবদ্ধতা এবং আকারের গ্রানুলারিটি রয়েছে। আপলোডটি একাধিক খণ্ডে করা হলে, শেষ আপলোড ব্যতীত সমস্ত আপলোড এই মানের গুণিতকগুলিতে করা আবশ্যক৷ অর্থাৎ, ফাইলের আপলোড বাইটগুলিকে এই মানের সাথে সারিবদ্ধ করতে হবে। শেষ অংশে, আপনি অবশিষ্ট বাইট আপলোড করতে পারেন।

হেডার ক্ষেত্র X-Goog-Upload-URL একটি অনন্য URL রয়েছে যা বাকি সমস্ত অনুরোধের মাধ্যমে আপলোড সম্পূর্ণ করতে ব্যবহার করা আবশ্যক৷ এই পুনঃসূচনাযোগ্য সেশন URLটি অনুলিপি করুন এবং সংরক্ষণ করুন, যাতে আপনি পরবর্তী অনুরোধগুলির জন্য এটি ব্যবহার করতে পারেন।

ধাপ 3: ফাইল আপলোড করা হচ্ছে

একটি পুনরায় শুরু করা সেশন সহ একটি ফাইল আপলোড করার দুটি উপায় রয়েছে:

1. একক অনুরোধে। এই পদ্ধতিটি সাধারণত সর্বোত্তম, কারণ এটির জন্য কম অনুরোধের প্রয়োজন হয় এবং এইভাবে আরও ভাল কর্মক্ষমতা রয়েছে।

2. একাধিক খণ্ডে। এই পদ্ধতিতে, ডেটা খণ্ড করে একাধিক অনুরোধে আপলোড করা হয়। ডেটা x-goog-upload-chunk-granularity এর গুণে খণ্ডিত হয়। প্রয়োজনে, খণ্ডিত অনুরোধগুলি পুনরায় চেষ্টা করা যেতে পারে।

   এই পদ্ধতিটি ব্যবহার করুন যদি:

   • আপনাকে যেকোনো একক অনুরোধে স্থানান্তরিত ডেটার পরিমাণ কমাতে হবে। পৃথক অনুরোধের জন্য একটি নির্দিষ্ট সময়সীমা থাকলে আপনাকে এটি করতে হতে পারে।
   • আপনাকে আপলোডের অগ্রগতি দেখানো একটি কাস্টমাইজড সূচক প্রদান করতে হবে।
   • আপনার জানতে হবে কখন ডেটা বাতিল করা নিরাপদ।

উদাহরণ

POST https://photoslibrary.googleapis.com/v1/uploads HTTP/1.1
Content-Length: 0
X-Goog-Upload-Command: start
X-Goog-Upload-Content-Type: image/jpeg
X-Goog-Upload-Protocol: resumable
X-Goog-Upload-Raw-Size: 3039417
[no body]

HTTP/1.1 200 OK
X-Goog-Upload-URL: https://photoslibrary.googleapis.com/v1/uploads?upload_id=AEnB2Urq&upload_protocol=resumable
X-Goog-Upload-Chunk-Granularity: 262144

POST https://photoslibrary.googleapis.com/v1/uploads?upload_id=AEnB2Urq&upload_protocol=resumable HTTP/1.1
Content-Length: 3039417
X-Goog-Upload-Command: upload, finalize
X-Goog-Upload-Offset: 0

[BYTES 0-4199999]

POST https://photoslibrary.googleapis.com/v1/uploads HTTP/1.1
Content-Length: 0
X-Goog-Upload-Command: start
X-Goog-Upload-Content-Type: image/jpeg
X-Goog-Upload-Protocol: resumable
X-Goog-Upload-Raw-Size: 3039417
[no body]

HTTP/1.1 200 OK
X-Goog-Upload-URL: https://photoslibrary.googleapis.com/v1/uploads?upload_id=AEnB2Urq&upload_protocol=resumable
X-Goog-Upload-Chunk-Granularity: 262144

POST https://photoslibrary.googleapis.com/v1/uploads?upload_id=AEnB2Urq&upload_protocol=resumable HTTP/1.1
Content-Length: 1048576
X-Goog-Upload-Command: upload
X-Goog-Upload-Offset: 0

[BYTES 0-1048575]

POST https://photoslibrary.googleapis.com/v1/uploads?upload_id=AEnB2Urq&upload_protocol=resumable HTTP/1.1
Content-Length: 1048576
X-Goog-Upload-Command: upload
X-Goog-Upload-Offset: 1048576

[BYTES 1048576-2097151]

POST https://photoslibrary.googleapis.com/v1/uploads?upload_id=AEnB2Urq&upload_protocol=resumable HTTP/1.1
Content-Length: 942265
X-Goog-Upload-Command: upload, finalize
X-Goog-Upload-Offset: 2097152

[BYTES 2097152-4200000]

একটি বাধাপ্রাপ্ত আপলোড পুনরায় শুরু করা হচ্ছে৷

আপলোডের অনুরোধ বাধাগ্রস্ত হলে বা আপনি যদি একটি নন- 200 HTTP স্ট্যাটাস কোড পান, তাহলে কতটা আপলোড সফল হয়েছে তা জানতে সার্ভারকে জিজ্ঞাসা করুন।

এখানে পুনঃসূচনাযোগ্য সেশন URL-এ একটি POST অনুরোধ রয়েছে৷ X-Goog-Upload-Command query সেট করা উচিত।

POST https://photoslibrary.googleapis.com/v1/uploads?upload_id=AEnB2Urq&upload_protocol=resumable HTTP/1.1
Content-Length: 0
X-Goog-Upload-Command: query

সার্ভারের প্রতিক্রিয়া একটি 200 OK HTTP স্ট্যাটাস কোড এবং আপলোডের বর্তমান আকার অন্তর্ভুক্ত করে।

HTTP/1.1 200 OK
X-Goog-Upload-Status: active
X-Goog-Upload-Size-Received: 100

তারপরে আপনি এই অফসেটে আপলোড পুনরায় শুরু করতে পারেন। আপনাকে অবশ্যই সার্ভার দ্বারা প্রদত্ত অফসেটে পুনরায় শুরু করতে হবে যদি না আপনি একটি সম্মিলিত আপলোড এবং চূড়ান্ত কমান্ড না পাঠান, এই ক্ষেত্রে আপনি অফসেট 0 এ পুনরায় শুরু করতে পারেন।

যদি আপনার ক্যোয়ারী কমান্ডের HTTP প্রতিক্রিয়াতে X-Goog-Upload-Status শিরোনামটি উপস্থিত থাকে এবং মানটি active না হয় তবে এটি ইঙ্গিত দেয় যে আপলোড ইতিমধ্যেই বন্ধ হয়ে গেছে৷