इस पेज पर उन अलग-अलग तरह की गड़बड़ियों और चेतावनियों के बारे में बताया गया है, जिनका इस्तेमाल Display & Video 360 API का इस्तेमाल करते समय हो सकता है.
एपीआई से जुड़ी गड़बड़ियां
अगर एपीआई को अनुरोध भेजने की प्रक्रिया पूरी नहीं की जा सकती, तो गड़बड़ी का मैसेज दिखता है. बार-बार होने वाली गड़बड़ियों की संख्या, उपयोगकर्ता के कोटा में गिना जाता है. अतिरिक्त कोटा के लिए मिले अनुरोधों की समीक्षा करते समय, इन अनुरोधों पर विचार किया जाएगा. गड़बड़ी के जवाबों को प्रोसेस और मैनेज किया जाना चाहिए, ताकि आने वाले समय में गड़बड़ियों से बचा जा सके.
गड़बड़ी का जवाब देने के लिए यह फ़ॉर्मैट अपनाया जाता है. इसमें एक एचटीटीपी रिस्पॉन्स कोड, गड़बड़ी का मैसेज, और Google RPC कोड की स्थिति शामिल होती है:
{
"error": {
"code": integer,
"message": string,
"status": enum (google.rpc.Code)
}
}
नीचे एपीआई की सामान्य गड़बड़ियों की सूची दी गई है. साथ ही, गड़बड़ियों का पता लगाने के लिए सुझाई गई कार्रवाई भी बताई गई है:
| कोड | RPC | सुझाई गई कार्रवाई |
|---|---|---|
400
|
INVALID_ARGUMENT
|
आपके अनुरोध में कोई गड़बड़ी है. गड़बड़ी के जवाब में मैसेज फ़ील्ड की समीक्षा करें और उसके मुताबिक अपने अनुरोध में बदलाव करें. |
401
|
UNAUTHENTICATED
|
आपके अनुरोध की सही तरीके से पुष्टि नहीं की जा सकी. पुष्टि करें कि आपने अनुरोध में मान्य OAuth क्रेडेंशियल शामिल किए हैं. इस बारे में ज़्यादा जानकारी के लिए, कृपया हमारे शुरुआती निर्देश देखें. |
403
|
PERMISSION_DENIED
|
आपके पास अपना अनुरोध पूरा करने के लिए ज़रूरी अनुमतियां नहीं हैं. पुष्टि करें कि आपके उपयोगकर्ता खाते के पास काम के पार्टनर या विज्ञापन देने वाले के लिए ज़रूरी अनुमतियां हैं. |
404
|
NOT_FOUND
|
आप जिस संसाधन को वापस पाने की कोशिश कर रहे हैं वह नहीं मिला. पुष्टि करें कि जिस आईडी का इस्तेमाल किया जा रहा है वह सही है. साथ ही, संसाधन टाइप को फिर से पाने के लिए भी ज़रूरी है. |
409
|
ABORTED
|
आप जिस संसाधन को संशोधित करने का प्रयास कर रहे हैं उसे किसी अन्य स्थान पर संशोधित किया जा रहा है. कुछ सेकंड इंतज़ार करें और फिर से अनुरोध करने की कोशिश करें. |
429
|
RESOURCE_EXHAUSTED
|
आपने अनुरोध करने की तय सीमा या हर दिन की तय सीमा पूरी कर ली है.
Google API कंसोल की मदद से अपने एपीआई के इस्तेमाल की जांच करें और मौजूदा कोटा सीमाओं के अंदर काम करने के लिए, अपने वर्कफ़्लो में बदलाव करें. ज़्यादा जानकारी के लिए, कृपया कोटा ऑप्टिमाइज़ेशन
पर हमारा पेज देखें. अगर हर दिन के तय कोटे में आपके काम पूरे नहीं हो पाते, तो अतिरिक्त कोटा का अनुरोध किया जा सकता है. |
500
|
INTERNAL
|
एपीआई में कोई अंदरूनी गड़बड़ी हुई. कुछ सेकंड इंतज़ार करने के बाद फिर से कोशिश करें. अगर गड़बड़ी बनी रहती है, तो सहायता टीम से संपर्क करें. |
504
|
DEADLINE_EXCEEDED
|
एपीआई को अनुरोध पूरा करने में बहुत ज़्यादा समय लगा. कुछ सेकंड इंतज़ार करने के बाद, फिर से कोशिश करें. अगर गड़बड़ी बनी रहती है, तो सहायता टीम से संपर्क करें. |
एसडीएफ़ से जुड़ी गड़बड़ियां
Display & Video 360 API, स्ट्रक्चर्ड डेटा फ़ाइलें (एसडीएफ़) जनरेट करने और डाउनलोड करने के लिए, एसिंक्रोनस तरीके का इस्तेमाल करता है. इसी वजह से, एसडीएफ़ जनरेशन के दौरान होने वाली गड़बड़ियां, एसडीएफ़ डाउनलोड करने के पूरा हो चुके टास्क में लौटा दी जाती हैं. error में पूरा हुआ एसडीएफ़ डाउनलोड टास्क को 'हो गया' के तौर पर मार्क किया गया. हालांकि, response फ़ील्ड में मीडिया रिसॉर्स के नाम के बजाय, गड़बड़ी वाला फ़ील्ड अपने-आप भरा हुआ है, जैसा कि इस छोटे किए गए उदाहरण में दिखाया गया है:
{
...
"done": true,
"error": {
"code": 3,
"message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
}
}
अगर SDF जनरेट करते समय आपको कार्रवाई करने लायक गड़बड़ी का मैसेज मिलता है, तो आपको उसका पालन करना चाहिए. अगर गड़बड़ी के मैसेज पर साफ़ तौर पर कार्रवाई नहीं की जा सकती, तो हमारा सुझाव है कि आप ये कार्रवाइयां करें:
- पुष्टि करें कि आपके उपयोगकर्ता के पास, पैरंट पार्टनर या विज्ञापन देने वाले के संसाधनों के लिए ज़रूरी अनुमतियां हैं.
- पुष्टि करें कि फ़िल्टर में दिए गए आईडी सटीक हैं, सही संसाधन टाइप के मुताबिक हैं, और दिए गए रूट आईडी के मुताबिक हैं.
- ध्यान रखें कि आपने हर उपयोगकर्ता को एक ही समय पर बीस डाउनलोड काम करने की सीमा को पार न किया हो.
अगर आपको अब भी गड़बड़ियां दिख रही हैं, तो समस्या की शिकायत करने के लिए सहायता टीम से संपर्क करें.
ब्लॉक न होने से जुड़ी चेतावनियां
ब्लॉक न करने वाली चेतावनियां, लाइन आइटम को असाइन की जाती हैं. इन्हें, उस समस्या के बारे में बताने के लिए असाइन किया जाता है जिसका असर लाइन आइटम को दिखाने पर हो सकता है. इस तरह की चेतावनियों को यूज़र इंटरफ़ेस (यूआई) में
सूचना बैनर के ज़रिए बताया जाता है. ये चेतावनियां काम नहीं करती हैं और
लाइन आइटम के warningMessages फ़ील्ड में दिखती हैं.
हालांकि ये चेतावनियां साफ़ नहीं दिखती हैं, लेकिन इनकी वजह से लाइन आइटम को दिखाने पर काफ़ी असर पड़ सकता है. इससे लाइन आइटम को पूरी तरह से रोका जा सकता है.
रोकथाम
लाइन आइटम सेटिंग के सही कॉन्फ़िगरेशन से ऐसी कई समस्याओं से बचा जा सकता है जो ब्लॉक न होने वाली चेतावनियों की वजह बनती हैं. इन समस्याओं से बचा जा सकता है:
- फ़्लाइट: अगर किसी लाइन आइटम की फ़्लाइट अमान्य है या पैरंट इंसर्शन ऑर्डर की फ़्लाइट की समयसीमा खत्म हो गई है, तो लाइन आइटम एक चेतावनी जनरेट करेगा और यह सेवा नहीं देगा. बाद वाली समस्या से बचने के लिए, पक्का करें कि किसी लाइन आइटम की फ़्लाइट, पैरंट इंसर्शन ऑर्डर की फ़्लाइट के बाद खत्म न हो.
- असाइन किए गए क्रिएटिव: अगर किसी लाइन आइटम के लिए कोई मान्य क्रिएटिव असाइन नहीं किया गया है, तो लाइन आइटम एक चेतावनी जनरेट करेगा और वह नहीं दिखेगा.
- टारगेटिंग: अगर किसी लाइन आइटम की टारगेटिंग को सही तरीके से असाइन नहीं किया गया है, तो लाइन आइटम एक चेतावनी दे सकता है और उसके लिए चेतावनी दिखाई जा सकती है. साथ ही, विज्ञापन दिखाने पर पूरी तरह से असर पड़ सकता है या पूरी तरह से रोका जा सकता है.
अगर किसी मौजूदा लाइन आइटम के कॉन्फ़िगरेशन की नकल की जा रही है, तो पक्का करें कि मौजूदा लाइन आइटम कोई ऐसी चेतावनी जनरेट न कर रहा हो जिसके बारे में अनुमान न लगाया गया हो.
निगरानी
ऐसी समस्याएं जिनके कारण ब्लॉक न की जाने वाली चेतावनियां मिलती हैं, किसी लाइन आइटम के उड़ान भरने के दौरान आ सकती हैं. यह पक्का करने के लिए कि आपके लाइन आइटम सही तरीके से काम कर रहे हैं, अपने चालू लाइन आइटम पर हाल में जनरेट हुई चेतावनियों के लिए नज़र रखें. advertisers.lineItems.list फ़ंक्शन का इस्तेमाल करके, लाइन आइटम को एक साथ वापस लाया जा सकता है. अगर कोई लाइन आइटम अचानक से चेतावनी जनरेट कर रहा है, तो विज्ञापन दिखाने पर पड़ने वाले असर को कम करने के लिए, आपको तुरंत समस्या को ठीक करना चाहिए.
किसी लाइन आइटम की सेटिंग या टारगेटिंग में बदलाव न होने पर भी समस्याएं आ सकती हैं. उदाहरण के लिए, पैरंट इंसर्शन ऑर्डर को रोकना या उसकी समयसीमा खत्म होना. साथ ही, उपयोगकर्ता सूचियों या अन्य टारगेटिंग का बंद होना भी इसके उदाहरण हैं.