Play की गेम सेवाएं Publishing API की मदद से, किसी गेम रिसॉर्स के लिए इमेज अपलोड की जा सकती है.
अपलोड करने के विकल्प
Play Games Services Publishing API की मदद से, कुछ तरह का बाइनरी डेटा या मीडिया अपलोड किया जा सकता है. अपलोड किए जा सकने वाले डेटा की खास बातें, मीडिया अपलोड करने की सुविधा देने वाले किसी भी तरीके के रेफ़रंस पेज पर बताई गई हैं:
अपलोड की जा सकने वाली फ़ाइल का ज़्यादा से ज़्यादा साइज़: इस तरीके से, ज़्यादा से ज़्यादा इतना डेटा स्टोर किया जा सकता है.
स्वीकार किए गए मीडिया एमआईएमई टाइप: इस तरीके का इस्तेमाल करके, इस तरह का बाइनरी डेटा सेव किया जा सकता है.
अपलोड करने के अनुरोध इनमें से किसी भी तरीके से किए जा सकते हैं. uploadType अनुरोध पैरामीटर के साथ, इस्तेमाल किए जा रहे तरीके के बारे में बताएं.
आसानी से अपलोड करना:
uploadType=media. छोटी फ़ाइलों को तेज़ी से ट्रांसफ़र करने के लिए. जैसे, 5 एमबी या इससे कम.मल्टीपार्ट अपलोड:
uploadType=multipart. छोटी फ़ाइलों और मेटाडेटा को तुरंत ट्रांसफ़र करने के लिए; यह फ़ाइल को उसके बारे में बताने वाले मेटाडेटा के साथ ट्रांसफ़र करता है. यह सब एक ही अनुरोध में होता है.फिर से शुरू किया जा सकने वाला अपलोड:
uploadType=resumable. भरोसेमंद तरीके से डेटा ट्रांसफ़र करने के लिए, खास तौर पर बड़ी फ़ाइलों के लिए. इस तरीके में, सेशन शुरू करने के अनुरोध का इस्तेमाल किया जाता है. इसमें मेटाडेटा शामिल किया जा सकता है. हालांकि, ऐसा करना ज़रूरी नहीं है. यह रणनीति ज़्यादातर ऐप्लिकेशन के लिए अच्छी है, क्योंकि यह छोटी फ़ाइलों के लिए भी काम करती है. हालांकि, इसके लिए हर अपलोड पर एक अतिरिक्त एचटीटीपी अनुरोध करना पड़ता है.
मीडिया अपलोड करते समय, आपको एक खास यूआरआई का इस्तेमाल करना होता है. असल में, मीडिया अपलोड करने की सुविधा देने वाले तरीकों में दो यूआरआई एंडपॉइंट होते हैं:
मीडिया के लिए /upload यूआरआई. अपलोड एंडपॉइंट का फ़ॉर्मैट, “/upload” प्रीफ़िक्स वाला स्टैंडर्ड रिसॉर्स यूआरआई होता है. मीडिया डेटा ट्रांसफ़र करते समय, इस यूआरआई का इस्तेमाल करें.
उदाहरण:
POST /upload/games/v1configuration/images/resourceId/imageType/imageTypeमेटाडेटा के लिए स्टैंडर्ड रिसोर्स यूआरआई. अगर संसाधन में कोई डेटा फ़ील्ड मौजूद है, तो उन फ़ील्ड का इस्तेमाल अपलोड की गई फ़ाइल के बारे में बताने वाले मेटाडेटा को सेव करने के लिए किया जाता है. मेटाडेटा वैल्यू बनाते या अपडेट करते समय, इस यूआरआई का इस्तेमाल किया जा सकता है.
उदाहरण:
POST /games/v1configuration/images/resourceId/imageType/imageType
आसानी से अपलोड करना
फ़ाइल अपलोड करने का सबसे आसान तरीका, अपलोड करने का सामान्य अनुरोध करना है. यह विकल्प तब चुनें, जब इनमें से कोई एक बात सही हो:
अगर कनेक्शन काम नहीं करता है, तो पूरी फ़ाइल को फिर से अपलोड किया जा सकता है.
भेजने के लिए कोई मेटाडेटा नहीं है. ऐसा तब हो सकता है, जब आपको इस संसाधन के लिए मेटाडेटा को अलग अनुरोध में भेजना हो. इसके अलावा, ऐसा तब भी हो सकता है, जब कोई मेटाडेटा काम न करता हो या उपलब्ध न हो. अपलोड करने के सामान्य तरीके का इस्तेमाल करने के लिए, /upload यूआरआई पर POST या PUT अनुरोध करें. साथ ही, uploadType=media क्वेरी पैरामीटर जोड़ें. उदाहरण के लिए:
POST https://www.googleapis.com/upload/games/v1configuration/images/resourceId/imageType/imageType?uploadType=media
सामान्य अपलोड अनुरोध करते समय इस्तेमाल किए जाने वाले एचटीटीपी हेडर में ये शामिल हैं:
Content-Type. इसे अपलोड किए जा सकने वाले मीडिया डेटा टाइप के किसी एक तरीके पर सेट करें. यह Publishing API के रेफ़रंस में बताया गया है.Content-Length. इसे अपलोड किए जा रहे बाइट की संख्या पर सेट करें. अगर चंक किए गए ट्रांसफ़र एन्कोडिंग का इस्तेमाल किया जा रहा है, तो इसकी ज़रूरत नहीं है.
उदाहरण: सामान्य अपलोड
यहां दिए गए उदाहरण में, Play की गेम सेवाएं 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
अगर अनुरोध पूरा हो जाता है, तो सर्वर, एचटीटीपी 200 OK स्टेटस कोड के साथ-साथ कोई भी मेटाडेटा दिखाता है. उदाहरण के लिए:
HTTP/1.1 200
Content-Type: application/json
{
"kind": "gamesConfiguration#imageConfiguration",
"url": string,
"resourceId": string,
"imageType": string
}
कई हिस्सों में अपलोड करना
अगर आपको अपलोड किए जाने वाले डेटा के साथ मेटाडेटा भी भेजना है, तो multipart/related के लिए एक ही अनुरोध किया जा सकता है. अगर भेजा जा रहा डेटा इतना छोटा है कि कनेक्शन फ़ेल होने पर उसे फिर से पूरी तरह से अपलोड किया जा सकता है, तो यह विकल्प सबसे सही है.
मल्टीपार्ट अपलोड का इस्तेमाल करने के लिए, POST या PUT तरीके के /upload यूआरआई पर अनुरोध करें और क्वेरी पैरामीटर uploadType=multipart जोड़ें. उदाहरण के लिए:
POST https://www.googleapis.com/upload/games/v1configuration/images/resourceId/imageType/imageType?uploadType=multipart
कई हिस्सों में अपलोड करने का अनुरोध करते समय, टॉप-लेवल के इन एचटीटीपी हेडर का इस्तेमाल किया जा सकता है:
-Content-Type. इसे multipart/related पर सेट करें. साथ ही, वह बाउंड्री स्ट्रिंग शामिल करें जिसका इस्तेमाल अनुरोध के हिस्सों की पहचान करने के लिए किया जा रहा है.
-Content-Length. इसे अनुरोध के मुख्य हिस्से में मौजूद बाइट की कुल संख्या पर सेट करें. अनुरोध का मीडिया हिस्सा, इस तरीके की फ़ाइल के लिए तय किए गए ज़्यादा से ज़्यादा साइज़ से कम होना चाहिए.
अनुरोध के मुख्य हिस्से को multipart/related कॉन्टेंट टाइप RFC2387 के तौर पर फ़ॉर्मैट किया गया हो और इसमें सिर्फ़ दो हिस्से हों. इन हिस्सों की पहचान, बाउंड्री स्ट्रिंग से की जाती है. साथ ही, आखिरी बाउंड्री स्ट्रिंग के बाद दो हाइफ़न होते हैं.
एक से ज़्यादा हिस्सों वाले अनुरोध के हर हिस्से के लिए, Content-Type हेडर की ज़रूरत होती है:
मेटाडेटा वाला हिस्सा: यह सबसे पहले होना चाहिए. साथ ही, Content-Type, मेटाडेटा के स्वीकार किए गए फ़ॉर्मैट में से किसी एक से मेल खाना चाहिए.
मीडिया पार्ट: यह दूसरा होना चाहिए. साथ ही, कॉन्टेंट टाइप, तरीके के स्वीकार किए गए मीडिया एमआईएमई टाइप में से किसी एक से मेल खाना चाहिए.
हर तरीके के लिए, स्वीकार किए जाने वाले मीडिया एमआईएमई टाइप और अपलोड की गई फ़ाइलों के साइज़ की सीमाएं देखने के लिए, Publishing API रेफ़रंस देखें.
उदाहरण: मल्टीपार्ट अपलोड
यहां दिए गए उदाहरण में, Play की गेम सेवाएं 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--
अनुरोध पूरा होने पर, सर्वर एचटीटीपी 200 OK स्टेटस कोड के साथ-साथ कोई भी मेटाडेटा दिखाता है:
HTTP/1.1 200
Content-Type: application/json
{
"kind": "gamesConfiguration#imageConfiguration",
"url": string,
"resourceId": string,
"imageType": string
}
फिर से अपलोड किया जा सकता है
डेटा फ़ाइलों को ज़्यादा भरोसेमंद तरीके से अपलोड करने के लिए, फिर से शुरू किए जा सकने वाले अपलोड प्रोटोकॉल का इस्तेमाल किया जा सकता है. इस प्रोटोकॉल की मदद से, डेटा ट्रांसफ़र के दौरान कनेक्शन टूट जाने पर, अपलोड करने की प्रोसेस को फिर से शुरू किया जा सकता है. यह सुविधा खास तौर पर तब फ़ायदेमंद होती है, जब आपको बड़ी फ़ाइलें ट्रांसफ़र करनी हों और नेटवर्क में रुकावट आने या ट्रांसमिशन में किसी अन्य तरह की समस्या होने की आशंका ज़्यादा हो. उदाहरण के लिए, मोबाइल क्लाइंट ऐप्लिकेशन से अपलोड करते समय. नेटवर्क में गड़बड़ी होने पर, यह सुविधा आपके बैंडविथ के इस्तेमाल को भी कम कर सकती है. ऐसा इसलिए, क्योंकि आपको बड़ी फ़ाइलों को शुरू से अपलोड नहीं करना पड़ता.
फिर से शुरू किए जा सकने वाले अपलोड की सुविधा का इस्तेमाल करने के लिए, यह तरीका अपनाएं:
फिर से शुरू किया जा सकने वाला सेशन शुरू करें. अपलोड यूआरआई को शुरुआती अनुरोध भेजें. इसमें मेटाडेटा शामिल करें.
फिर से शुरू किए जा सकने वाले सेशन का यूआरआई सेव करें. जवाब में मिले सेशन यूआरआई को सेव करें. इसका इस्तेमाल, इस सेशन के बाकी अनुरोधों के लिए किया जाएगा. फ़ाइल अपलोड करें.
मीडिया फ़ाइल को फिर से शुरू किए जा सकने वाले सेशन के यूआरआई पर भेजें.
इसके अलावा, जिन ऐप्लिकेशन में फिर से शुरू किए जाने लायक अपलोड की सुविधा का इस्तेमाल किया जाता है उनमें अपलोड के बीच में रुक जाने पर, उसे फिर से शुरू करने के लिए कोड होना चाहिए. अगर अपलोड करने की प्रोसेस में रुकावट आती है, तो पता लगाएं कि कितना डेटा अपलोड हो चुका है. इसके बाद, अपलोड करने की प्रोसेस को वहीं से फिर से शुरू करें.
फिर से शुरू किया जा सकने वाला सेशन शुरू करना
फिर से शुरू किए जा सकने वाले अपलोड की प्रोसेस शुरू करने के लिए, POST या PUT अनुरोध को तरीके के /upload यूआरआई पर भेजें. साथ ही, क्वेरी पैरामीटर uploadType=resumable जोड़ें. उदाहरण के लिए:
POST https://www.googleapis.com/upload/games/v1configuration/images/resourceId/imageType/imageType?uploadType=resumable
इस शुरुआती अनुरोध के मुख्य हिस्से में, मेटाडेटा शामिल होता है या यह खाली होता है. आपको जिस फ़ाइल को अपलोड करना है उसका कॉन्टेंट, आने वाले अनुरोधों में ट्रांसफ़र किया जाएगा.
शुरुआती अनुरोध के साथ इन एचटीटीपी हेडर का इस्तेमाल करें:
X-Upload-Content-Type. इसे अपलोड किए जाने वाले डेटा के मीडिया एमआईएमई टाइप पर सेट करें, ताकि इसे आने वाले अनुरोधों में ट्रांसफ़र किया जा सके.X-Upload-Content-Length. इसे अपलोड किए जाने वाले डेटा के बाइट की संख्या पर सेट करें. यह डेटा, आने वाले अनुरोधों में ट्रांसफ़र किया जाएगा. अगर इस अनुरोध के समय लंबाई की जानकारी नहीं है, तो इस हेडर को हटाया जा सकता है.मेटाडेटा उपलब्ध कराने पर:
Content-Type. मेटाडेटा के डेटा टाइप के हिसाब से सेट किया जाता है.Content-Length. इसे इस शुरुआती अनुरोध के मुख्य हिस्से में दिए गए बाइट की संख्या पर सेट करें. अगर chunked transfer encoding का इस्तेमाल किया जा रहा है, तो इसकी ज़रूरत नहीं है.
हर तरीके के लिए, स्वीकार किए गए मीडिया MIME टाइप और अपलोड की गई फ़ाइलों के साइज़ की सीमा की सूची देखने के लिए, Publishing API का रेफ़रंस देखें.
उदाहरण: सेशन को फिर से शुरू करने का अनुरोध
यहां दिए गए उदाहरण में, Play की गेम सेवाएं 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
}
अगले सेक्शन में, जवाब को मैनेज करने का तरीका बताया गया है.
इस कुकी का इस्तेमाल, फिर से शुरू किए जा सकने वाले सेशन के यूआरआई को सेव करने के लिए किया जाता है
अगर सेशन शुरू करने का अनुरोध पूरा हो जाता है, तो एपीआई सर्वर, 200
OK एचटीटीपी स्टेटस कोड के साथ जवाब देता है. इसके अलावा, यह Location हेडर भी उपलब्ध कराता है, जो आपके फिर से शुरू किए जा सकने वाले सेशन का यूआरआई बताता है. नीचे दिए गए उदाहरण में दिखाए गए 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 हेडर की वैल्यू, सेशन यूआरआई है. इसका इस्तेमाल, फ़ाइल अपलोड करने या अपलोड की स्थिति के बारे में क्वेरी करने के लिए, एचटीटीपी एंडपॉइंट के तौर पर किया जाएगा.
सेशन यूआरआई को कॉपी करके सेव करें, ताकि इसका इस्तेमाल बाद के अनुरोधों के लिए किया जा सके.
फ़ाइल अपलोड करना
फ़ाइल अपलोड करने के लिए, पिछले चरण में मिले अपलोड यूआरआई को PUT अनुरोध भेजें. अपलोड करने के अनुरोध का फ़ॉर्मैट यह है:
PUT session_uri
फ़ाइल को फिर से शुरू किए जाने लायक अपलोड करने के अनुरोध करते समय इस्तेमाल किए जाने वाले एचटीटीपी हेडर में ये शामिल हैं
Content-Length. इस हेडर को, इस अनुरोध में अपलोड किए जा रहे बाइट की संख्या पर सेट करें. आम तौर पर, यह अपलोड की जाने वाली फ़ाइल का साइज़ होता है.
उदाहरण: फ़ाइल अपलोड करने के अनुरोध को फिर से शुरू करना
यहां मौजूदा उदाहरण के लिए, पूरी 20,00,000 बाइट की 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-Range हेडर भी ज़रूरी है. साथ ही, पूरी फ़ाइल अपलोड करने के लिए Content-Length हेडर भी ज़रूरी है:
Content-Length. इसे चंक के साइज़ पर सेट करें या हो सकता है कि यह इससे कम हो. ऐसा आखिरी अनुरोध के मामले में हो सकता है.Content-Range. इसे सेट करके यह दिखाया जाता है कि अपलोड की जा रही फ़ाइल में कौनसे बाइट हैं. उदाहरण के लिए,Content-Range: bytes 0-524287/2000000से पता चलता है कि 2,000,000 बाइट की फ़ाइल में, पहले 5,24,288 बाइट (256 x 1024 x 2) दिए जा रहे हैं.
अपलोड करने की प्रोसेस के बीच में रुक जाने पर उसे फिर से शुरू करना
अगर अपलोड करने का अनुरोध, जवाब मिलने से पहले ही बंद हो जाता है या आपको सर्वर से HTTP 503 Service Unavailable जवाब मिलता है, तो आपको अपलोड करने की प्रोसेस फिर से शुरू करनी होगी. अपलोड करने की प्रोसेस में रुकावट आने पर, उसे फिर से शुरू करने के लिए यह तरीका अपनाएं:
अनुरोध की स्थिति. अपलोड यूआरआई को खाली
PUTअनुरोध भेजकर, अपलोड का मौजूदा स्टेटस क्वेरी करें. इस अनुरोध के लिए, एचटीटीपी हेडर मेंContent-Rangeहेडर शामिल होना चाहिए. इससे पता चलता है कि फ़ाइल में मौजूदा पोज़िशन के बारे में जानकारी नहीं है. उदाहरण के लिए, अगर आपकी फ़ाइल की कुल लंबाई 20,00,000 है, तोContent-Rangeको*/2000000पर सेट करें. अगर आपको फ़ाइल के पूरे साइज़ के बारे में नहीं पता है, तो Content-Range को*/*पर सेट करें.अपलोड किए गए बाइट की संख्या पाएं. स्थिति की क्वेरी से मिले जवाब को प्रोसेस करता है. सर्वर, अपने जवाब में
Rangeहेडर का इस्तेमाल करता है. इससे यह पता चलता है कि उसे अब तक कितने बाइट मिले हैं. उदाहरण के लिए,0-299999केRangeहेडर से पता चलता है कि फ़ाइल के पहले 3,00,000 बाइट मिल गए हैं.बाकी डेटा अपलोड करें. आखिर में, अब आपको पता चल गया है कि अनुरोध को कहां से फिर से शुरू करना है. इसलिए, बचा हुआ डेटा या मौजूदा हिस्सा भेजें. ध्यान दें कि आपको दोनों ही मामलों में, बचे हुए डेटा को एक अलग चंक के तौर पर मानना होगा. इसलिए, अपलोड फिर से शुरू करते समय आपको
Content-Rangeहेडर भेजना होगा.
उदाहरण: अपलोड करने की प्रोसेस में रुकावट आने पर उसे फिर से शुरू करना
अपलोड का स्टेटस पाने का अनुरोध करें. इस अनुरोध में Content-Range हेडर का इस्तेमाल किया गया है. इससे पता चलता है कि 20,00,000 बाइट वाली फ़ाइल में मौजूदा पोज़िशन के बारे में जानकारी नहीं है.
PUT {session_uri} HTTP/1.1 Content-Length: 0 Content-Range: bytes */2000000जवाब से, अब तक अपलोड किए गए बाइट की संख्या निकालें. सर्वर के जवाब में
Rangeहेडर का इस्तेमाल किया जाता है. इससे पता चलता है कि सर्वर को अब तक फ़ाइल के पहले 43 बाइट मिल चुके हैं. अपलोड फिर से शुरू करने के लिए, Range हेडर की ऊपरी वैल्यू का इस्तेमाल करें.HTTP/1.1 308 Resume Incomplete Content-Length: 0 Range: 0-42अपलोड करने की प्रोसेस को वहीं से शुरू करें जहां वह रुकी थी. नीचे दिए गए अनुरोध में, फ़ाइल के बचे हुए बाइट भेजे जाते हैं. यह प्रोसेस, बाइट 43 से शुरू होती है.
PUT {session_uri} HTTP/1.1 Content-Length: 1999957 Content-Range: bytes 43-1999999/2000000 bytes 43-1999999
गड़बड़ी ठीक करना
मीडिया अपलोड करते समय, गड़बड़ी ठीक करने से जुड़े कुछ सबसे सही तरीकों के बारे में जानना फ़ायदेमंद होता है.
कनेक्शन में रुकावट आने या 5xx गड़बड़ियों की वजह से, अपलोड नहीं हो पाने वाली फ़ाइलों को फिर से अपलोड करें. इनमें ये गड़बड़ियां शामिल हैं:
500 Internal Server Error502 Bad Gateway503 Service Unavailable504 Gateway Timeout
अपलोड करने के अनुरोधों को फिर से शुरू करने या फिर से कोशिश करने पर, अगर कोई
5xxसर्वर की गड़बड़ी दिखती है, तो एक्सपोनेंशियल बैकऑफ़ रणनीति का इस्तेमाल करें. अगर सर्वर पर बहुत ज़्यादा लोड है, तो ये गड़बड़ियां हो सकती हैं. एक्सपोनेंशियल बैकऑफ़ की मदद से, अनुरोधों की ज़्यादा संख्या या नेटवर्क ट्रैफ़िक ज़्यादा होने के दौरान, इस तरह की समस्याओं को कम किया जा सकता है.अन्य तरह के अनुरोधों को एक्स्पोनेंशियल बैकऑफ़ से हैंडल नहीं किया जाना चाहिए. हालांकि, आपके पास अब भी उनमें से कई को फिर से आज़माने का विकल्प होता है. इन अनुरोधों को फिर से करने की कोशिश करते समय, इनकी संख्या को सीमित करें. उदाहरण के लिए, आपका कोड गड़बड़ी की सूचना देने से पहले, ज़्यादा से ज़्यादा दस बार कोशिश कर सकता है या इससे कम बार कोशिश कर सकता है.
अपलोड फिर से शुरू करने की सुविधा का इस्तेमाल करते समय,
404 Not Foundऔर410 Goneगड़बड़ियों को ठीक करें. इसके लिए, अपलोड की प्रोसेस को शुरू से फिर से शुरू करें.
एक्स्पोनेंशियल बैकऑफ़
एक्सपोनेंशियल बैकऑफ़, नेटवर्क ऐप्लिकेशन के लिए गड़बड़ी ठीक करने की एक स्टैंडर्ड रणनीति है. इसमें क्लाइंट, तय समय-सीमा के दौरान बार-बार अनुरोध करता है. हालांकि, हर बार अनुरोध करने के बीच का समय बढ़ता जाता है. अगर ज़्यादा अनुरोधों या नेटवर्क ट्रैफ़िक की वजह से सर्वर में गड़बड़ियां होती हैं, तो उन गड़बड़ियों को ठीक करने के लिए, एक्सपोनेंशियल बैकऑफ़ एक अच्छी रणनीति हो सकती है. इसके उलट, यह रणनीति उन गड़बड़ियों को ठीक करने के लिए काम की नहीं है जो नेटवर्क वॉल्यूम या जवाब देने में लगने वाले समय से जुड़ी नहीं हैं. जैसे, पुष्टि करने के लिए अमान्य क्रेडेंशियल या फ़ाइल नहीं मिली गड़बड़ियां.
एक्सपोनेंशियल बैकऑफ़ का सही तरीके से इस्तेमाल करने पर, बैंडविथ के इस्तेमाल की क्षमता बढ़ जाती है. साथ ही, अनुरोधों की संख्या कम हो जाती है, ताकि जवाब मिल सके. इसके अलावा, एक साथ कई अनुरोध करने पर भी, थ्रूपुट ज़्यादा मिलता है.
सामान्य एक्सपोनेंशियल बैकऑफ़ को लागू करने का तरीका यहां दिया गया है:
- एपीआई से अनुरोध करें.
- आपको
HTTP 503जवाब मिलेगा. इससे पता चलता है कि आपको अनुरोध फिर से करना चाहिए. - एक सेकंड + random_number_milliseconds इंतज़ार करने के बाद, फिर से अनुरोध करें.
- आपको
HTTP 503जवाब मिलेगा. इससे पता चलता है कि आपको अनुरोध फिर से करना चाहिए. - दो सेकंड + random_number_milliseconds इंतज़ार करें और फिर से अनुरोध करें.
- आपको
HTTP 503जवाब मिलेगा. इससे पता चलता है कि आपको अनुरोध फिर से करना चाहिए. - चार सेकंड + random_number_milliseconds इंतज़ार करें और फिर से अनुरोध करें.
- आपको
HTTP 503 responseमिलेगा. इसका मतलब है कि आपको अनुरोध फिर से करना चाहिए. - आठ सेकंड + random_number_milliseconds इंतज़ार करने के बाद, फिर से अनुरोध करें.
- आपको
HTTP 503 responseमिलेगा. इसका मतलब है कि आपको अनुरोध फिर से करना चाहिए. - 16 सेकंड + random_number_milliseconds इंतज़ार करें और फिर से अनुरोध करें.
- बंद करो. किसी गड़बड़ी की शिकायत करें या उसे लॉग करें.
ऊपर दी गई सूची में, random_number_milliseconds, मिलीसेकंड की एक ऐसी रैंडम संख्या है जो 1,000 से कम या उसके बराबर है. यह ज़रूरी है, क्योंकि कुछ समय के लिए रैंडम डिले करने से, लोड को ज़्यादा एकसमान तरीके से डिस्ट्रिब्यूट करने में मदद मिलती है. साथ ही, सर्वर पर अचानक से बहुत ज़्यादा लोड पड़ने की संभावना से बचा जा सकता है. हर बार इंतज़ार करने के बाद, random_number_milliseconds की वैल्यू को फिर से तय करना होगा.
एल्गोरिदम को तब बंद करने के लिए सेट किया गया है, जब n की वैल्यू 5 हो. इस सीमा की वजह से, क्लाइंट बार-बार अनुरोध नहीं कर पाते. साथ ही, अनुरोध को "वह गड़बड़ी जिसकी वजह से डेटा वापस नहीं पाया जा सकता" के तौर पर मार्क करने से पहले, कुल 32 सेकंड का समय लगता है. अपलोड करने की प्रोसेस लंबी होने पर, फिर से कोशिश करने की ज़्यादा से ज़्यादा संख्या को बढ़ाया जा सकता है. हालांकि, फिर से कोशिश करने के बीच के समय को कम रखें. जैसे, एक मिनट से कम.