समस्या हल करना

Display & Video 360 API के साथ काम करते समय कई बार गड़बड़ियां हो सकती हैं. ये आपके कोड की किसी गड़बड़ी, अमान्य उपयोगकर्ता इनपुट या एपीआई में होने वाली किसी समस्या से भी जुड़े हो सकते हैं. वजह चाहे जो भी हो, गड़बड़ियों को ठीक करने का तरीका जानना, डेवलपमेंट प्रोसेस का एक अहम हिस्सा है. इस गाइड में, शुरुआत करने के सबसे सही तरीके बताए गए हैं.

बुनियादी बातें जानना

  1. ज़रूरी शर्तों की गाइड देखें. पक्का करें कि आपके पास Display & Video 360 का ऐक्सेस और सही तरीके से कॉन्फ़िगर किया गया एपीआई प्रोजेक्ट है.
  2. अगर आपके जवाब में एचटीटीपी की गड़बड़ियां हैं, तो इनकी ध्यान से समीक्षा करें. साथ ही, पक्का करें कि अनुरोध सही एपीआई और सेवा को किया जा रहा है.
  3. अनुमति देने से जुड़ी गाइड देखें. पक्का करें कि आपके अनुरोध में, ज़रूरी OAuth 2.0 क्रेडेंशियल शामिल हों.
  4. इस बात की पुष्टि करें कि आपने सही क्रेडेंशियल का इस्तेमाल किया है. पुष्टि करने के लिए क्रेडेंशियल जनरेट करने के बारे में ज़्यादा जानने के लिए, ऐप्लिकेशन सेट अप करने से जुड़ी गाइड देखें. आपके पास यह पक्का करने के लिए अपना ऐक्सेस टोकन Google OAuth2 API के टोकन जानकारी एंडपॉइंट पर पास करने का भी विकल्प है कि यह सही एपीआई प्रोजेक्ट को जारी किया गया है और सही स्कोप के लिए अधिकृत है:

    POST https://www.googleapis.com/oauth2/v2/tokeninfo?access_token={YOUR_ACCESS_TOKEN}
    
    200 OK
    
    {
     "issued_to": "{API_PROJECT_CLIENT_ID}",
     "audience": "...",
     "scope": "{API_SCOPES}",
     "expires_in": ...
    }
    

गड़बड़ियों को समझना

जब एपीआई को कोई गड़बड़ी मिलती है, तो आम तौर पर यह error ऑब्जेक्ट वाला JSON रिस्पॉन्स दिखाता है. यह ऑब्जेक्ट, सामने आई उस खास गड़बड़ी के बारे में ज़्यादा जानकारी देता है.

{
 "error": {
  "code": 404,
  "message": "Resource type LINE_ITEM does not exist: advertisers/1/lineItems/1",
  "status": "NOT_FOUND"
 }
}

आम तौर पर, error ऑब्जेक्ट के कॉन्टेंट में इतनी जानकारी होती है जिससे आपको गड़बड़ी का पता लगाने में मदद मिलती है. अगर ऐसा नहीं है, तो आपको गड़बड़ी का मतलब जानने के लिए कुछ और रिसर्च करनी पड़ सकती है.

गड़बड़ियों के बारे में रिसर्च करना

  1. सामान्य गड़बड़ियों का सेक्शन देखें. इसमें सबसे ज़्यादा बार होने वाली गड़बड़ियों के बारे में जानकारी मिलती है.

  2. अगर सामान्य गड़बड़ियों वाले सेक्शन में गड़बड़ी शामिल नहीं है, तो पहचान फ़ाइल के लिए दस्तावेज़ देखें और गड़बड़ी का कोड, स्थिति, और मैसेज खोजने की कोशिश करें.

  3. अगर आपको कोई ऐसी गड़बड़ी मिलती है जिसे दर्ज नहीं किया गया है, तो कृपया हमें बताएं.

असल वजह का पता लगाना

यहां तक आपने गड़बड़ी को पहचान लिया है और उसका मतलब समझ गए हैं. अगर नहीं, तो गड़बड़ियों को समझने के लिए वापस जाएं या अगर आपको लगता है कि एपीआई में कोई ऐसी गड़बड़ी हुई है जिसे आप खुद ठीक नहीं कर सकते, तो मदद पाने के लिए आगे बढ़ें.

गड़बड़ी ठीक करने से पहले, आपको इसकी वजह पहचान करनी होगी. अक्सर यह आपके कोड में कोई गड़बड़ी होगी या कोई अमान्य इनपुट वैल्यू होगी.

यह पता लगाने के लिए कि समस्या, आपके कोड में मौजूद किसी गड़बड़ी से जुड़ी है या नहीं, आपको पहले इस बात की पुष्टि करनी होगी कि आपका कोड उम्मीद के मुताबिक काम कर रहा है. सबसे पहले, कोड के उस सेक्शन की समीक्षा करें जो साफ़ तौर पर दिखने वाली समस्याओं की जांच करने में असफल होने के लिए ज़िम्मेदार है. कुछ मामलों में, यह पक्का करने के लिए कि कोड सही तरीके से काम कर रहा है या नहीं, डीबग करने वाले टूल का इस्तेमाल करना ज़रूरी हो सकता है.

एचटीटीपी अनुरोधों की जांच करना, संभावित गड़बड़ियों की पहचान करने का एक और अच्छा तरीका है. इससे अमान्य इनपुट के मामलों में भी मदद मिलती है. कई आधिकारिक क्लाइंट लाइब्रेरी को एचटीटीपी अनुरोधों और उनके जवाबों को लॉग करने के लिए कॉन्फ़िगर किया जा सकता है. ज़्यादा जानकारी के लिए अपनी पसंद की लाइब्रेरी के दस्तावेज़ देखें. अनुरोध और रिस्पॉन्स लॉग को कैप्चर करने के लिए, चार्ल्स, स्क्विड या फ़िडलर जैसे एचटीटीपी प्रॉक्सी का भी इस्तेमाल किया जा सकता है. ये लॉग मिलने के बाद, उनकी समीक्षा करके यह पक्का करें कि आपके ऐप्लिकेशन से मिले अनुरोध के पैरामीटर की वैल्यू सही हैं और आपकी उम्मीद के मुताबिक हैं.

गड़बड़ी या अमान्य इनपुट की पहचान कर लेने के बाद, उम्मीद है कि आपको समस्या का हल ज़रूर दिखेगा. अगर आपको समझ नहीं आ रहा कि समस्या को ठीक करने का तरीका क्या है, तो मदद पाने के लिए अब तक इकट्ठा की गई जानकारी का इस्तेमाल करें.

सहायता पाना

अगर आपसे किसी गड़बड़ी को खुद ठीक नहीं किया जा सकता, तो Display & Video 360 सहायता केंद्र में दिए गए इस फ़ॉर्म को भरकर हमारी सहायता टीम से संपर्क करें.

यह फ़ॉर्म भरते समय, आपको अपनी समस्या और अपनी समस्या को हल करने के लिए उठाए गए कदमों के बारे में ज़्यादा से ज़्यादा जानकारी देनी चाहिए. शामिल की जाने वाली उपयोगी जानकारी:

  • एचटीटीपी अनुरोध और रिस्पॉन्स लॉग. संवेदनशील जानकारी को छिपाने के लिए उसमें बदलाव करें.जैसे- OAuth 2.0 ऐक्सेस टोकन, ईमेल पते वगैरह
  • कोड स्निपेट. अगर आपको कोड के किसी खास सेक्शन में समस्या आ रही है या आपको लगता है कि समस्या किसी खास भाषा की है, तो एक छोटा स्निपेट शामिल करके बताएं कि आपको समस्या क्या है.
  • अतिरिक्त जानकारी, जैसे कि रनटाइम/इंटरप्रेटर का वर्शन और प्लैटफ़ॉर्म, जो समस्या को फिर से दिखाने की कोशिश करने वाले लोगों के लिए मददगार हो सकते हैं.

समस्या को ठीक करना

समस्या की वजह जानने और उसका समाधान करने के बाद, उसे ठीक करने का समय आ जाता है. जब भी हो सके, तब अच्छे और खराब, दोनों तरह के इनपुट की जांच करें. इसके लिए, प्रोडक्शन में लागू करने से पहले, नियंत्रित माहौल में (जैसे कि खास तौर पर टेस्ट करने के लिए कॉन्फ़िगर किया गया कोई पार्टनर या विज्ञापन देने वाला व्यक्ति या कंपनी) की जांच करें.