फिर से शुरू किए जा सकने वाले अपलोड

इस पेज पर, REST प्रोटोकॉल की मदद से, Google Photos Library API को फिर से शुरू किया जा सकने वाला अपलोड अनुरोध करने का तरीका बताया गया है. इस प्रोटोकॉल से, फ़ाइल अपलोड करने की प्रोसेस फिर से शुरू की जा सकती है कम्यूनिकेशन में गड़बड़ी होने पर, डेटा का फ़्लो बिगड़ जाता है.

फिर से शुरू किए जा सकने वाले अपलोड के विकल्प का इस्तेमाल तब करें, जब:

• बड़ी फ़ाइलें अपलोड की जा रही हैं.
• नेटवर्क में रुकावट या किसी अन्य ट्रांसमिशन की गड़बड़ी होने की संभावना है उच्च (उदाहरण के लिए, अगर आप किसी मोबाइल ऐप्लिकेशन से फ़ाइल अपलोड कर रहे हैं).

नेटवर्क के बंद होने पर, फिर से शुरू किए जा सकने वाले अपलोड की सुविधा से, बैंडविड्थ का इस्तेमाल भी कम किया जा सकता है. ऐसा इसलिए, क्योंकि आपको बड़ी फ़ाइलों को फिर से शुरू करने की ज़रूरत नहीं पड़ती.

पहला चरण: अपलोड सेशन शुरू करना

इस पते पर एक पोस्ट अनुरोध भेजकर, फिर से शुरू किए जा सकने वाले अपलोड सेशन को शुरू करें https://photoslibrary.googleapis.com/v1/uploads. इस अनुरोध में मिले, फिर से शुरू किए जा सकने वाले अपलोड के यूआरएल का इस्तेमाल करके, फ़ाइल अपलोड करें.

पीओएसटी अनुरोध में ये हेडर शामिल होने चाहिए:

यहां पोस्ट अनुरोध का हेडर दिया गया है:

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

दूसरा चरण: सेशन का यूआरएल सेव करना

सफल होने पर, पोस्ट अनुरोध एक 200 OK एचटीटीपी स्टेटस कोड दिखाता है, जिसमें यह शामिल होता है यहां दिया गया हेडर.

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 में एक यूनीक यूआरएल होता है. इसका इस्तेमाल इन कामों के लिए किया जाना चाहिए बचे हुए सभी अनुरोधों के ज़रिए, अपलोड पूरा करें. फिर से शुरू किए जा सकने वाले सेशन का यह यूआरएल कॉपी करके सेव करें, ताकि आने वाले समय में अनुरोध करने के लिए इसका इस्तेमाल किया जा सके.

तीसरा चरण: फ़ाइल अपलोड करना

फिर से शुरू किए जाने वाले सेशन वाली फ़ाइल को अपलोड करने के दो तरीके हैं:

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 एचटीटीपी स्टेटस मिलता है कोड डालकर, सर्वर से क्वेरी करके पता लगाएं कि कितना डेटा अपलोड हुआ.

यहां फिर से शुरू किए जा सकने वाले सेशन के यूआरएल के लिए 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/1.1 200 OK
X-Goog-Upload-Status: active
X-Goog-Upload-Size-Received: 100

इसके बाद, इस ऑफ़सेट से अपलोड फिर से शुरू किया जा सकता है. आपको ऑफ़सेट से शुरू करना होगा सर्वर से मिलने वाली जानकारी, जब तक कि एक साथ अपलोड करने और कमांड को फ़ाइनल करने की ज़रूरत नहीं होती. और इस मामले में, आप ऑफ़सेट 0 पर भी फिर से शुरू कर सकते हैं.

अगर आपकी क्वेरी कमांड के एचटीटीपी रिस्पॉन्स में X-Goog-Upload-Status हेडर मौजूद है और उसकी वैल्यू active नहीं है, तो इसका मतलब है कि अपलोड पहले ही बंद हो चुका है.