इस पेज पर, अलग-अलग तरह की गड़बड़ियों और चेतावनियों के बारे में बताया गया है. ये गड़बड़ियां और चेतावनियां, Display & Video 360 API का इस्तेमाल करते समय आपको मिल सकती हैं.
एपीआई से जुड़ी गड़बड़ियां
एपीआई से किए गए ऐसे अनुरोध जो पूरे नहीं किए जा सकते, गड़बड़ी का मैसेज दिखाते हैं. गड़बड़ियों की जानकारी देने वाले अनुरोधों को उपयोगकर्ता कोटा में गिना जाता है. साथ ही, ज़्यादा कोटा के अनुरोधों की समीक्षा करते समय इन अनुरोधों को ध्यान में रखा जाएगा. आने वाले समय में गड़बड़ियों से बचने के लिए, गड़बड़ी के जवाबों को प्रोसेस और मैनेज किया जाना चाहिए.
गड़बड़ी का रिस्पॉन्स इस फ़ॉर्मैट में होता है. इसमें एचटीटीपी रिस्पॉन्स कोड, गड़बड़ी का मैसेज, और Google आरपीसी कोड का स्टेटस शामिल होता है:
{
"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
|
अनुरोध पूरा करने में एपीआई को बहुत ज़्यादा समय लगा. कुछ सेकंड इंतज़ार करें और फिर से कोशिश करें. अगर गड़बड़ी बनी रहती है, तो सहायता टीम से संपर्क करें. |
SDF से जुड़ी गड़बड़ियां
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 डाउनलोड करने के 20 टास्क से ज़्यादा न हों.
अगर आपको अब भी गड़बड़ियां आ रही हैं, तो अपनी समस्या की शिकायत करने के लिए सहायता टीम से संपर्क करें.
ब्लॉक न करने वाली चेतावनियां
बिना ब्लॉक करने वाली चेतावनियां, लाइन आइटम को असाइन की जाती हैं. इससे, ऐसी समस्या का पता चलता है जिससे लाइन आइटम के विज्ञापन दिखाए जाने पर असर पड़ सकता है. ऐसी ही चेतावनियां, सूचना वाले बैनर के ज़रिए यूज़र इंटरफ़ेस (यूआई) में दी जाती हैं. ये चेतावनियां पैसिव होती हैं और इन्हें लाइन आइटम के warningMessages फ़ील्ड में दिखाया जाता है.
हालांकि, इन चेतावनियों की वजह से होने वाली समस्याएं, किसी लाइन आइटम को दिखाने पर असर डाल सकती हैं. इनसे, आइटम को दिखाने पर पूरी तरह से रोक भी लगाई जा सकती है.
रोकथाम
लाइन आइटम सेटिंग को सही तरीके से कॉन्फ़िगर करके, ऐसी कई समस्याओं से बचा जा सकता है जिनकी वजह से चेतावनियां मिलती हैं. इनमें ये समस्याएं शामिल हैं:
- फ़्लाइट: अगर किसी लाइन आइटम की फ़्लाइट अमान्य है या पैरंट इंसर्शन ऑर्डर की फ़्लाइट की समयसीमा खत्म हो गई है, तो लाइन आइटम से एक चेतावनी जनरेट होगी और वह नहीं दिखेगा. दूसरी समस्या से बचने के लिए, पक्का करें कि किसी लाइन आइटम की फ़्लाइट, उसके पैरंट इंसर्शन ऑर्डर की फ़्लाइट के बाद खत्म न हो.
- असाइन किए गए क्रिएटिव: अगर किसी लाइन आइटम में कोई मान्य क्रिएटिव असाइन नहीं किया गया है, तो लाइन आइटम एक चेतावनी जनरेट करेगा और विज्ञापन नहीं दिखाएगा.
- टारगेटिंग: अगर किसी लाइन आइटम की टारगेटिंग को सही तरीके से असाइन नहीं किया गया है, तो लाइन आइटम के लिए चेतावनी जनरेट हो सकती है. साथ ही, विज्ञापन दिखाने पर असर पड़ सकता है या उसे पूरी तरह से रोका जा सकता है.
अगर किसी मौजूदा लाइन आइटम से कॉन्फ़िगरेशन को डुप्लीकेट किया जा रहा है, तो पक्का करें कि मौजूदा लाइन आइटम से कोई अनचाही चेतावनी न जनरेट हो रही हो.
मॉनिटर करने के लिए
लाइन आइटम के प्रोसेस होने के दौरान, ऐसी समस्याएं आ सकती हैं जिनकी वजह से विज्ञापन ब्लॉक नहीं होते. यह पक्का करने के लिए कि आपके लाइन आइटम सही तरीके से दिखाए जा रहे हैं, नई जनरेट की गई चेतावनियों के लिए अपने ऐक्टिव लाइन आइटम पर नज़र रखें. advertisers.lineItems.list फ़ंक्शन का इस्तेमाल करके, लाइन आइटम एक साथ वापस पाए जा सकते हैं. अगर कोई लाइन आइटम अनचाही चेतावनी जनरेट कर रहा है, तो विज्ञापन दिखाने पर पड़ने वाले असर को कम करने के लिए, आपको तुरंत समस्या हल करनी चाहिए.
लाइन आइटम की सेटिंग या टारगेटिंग में बदलाव न होने पर भी समस्याएं आ सकती हैं. उदाहरण के लिए, पैरंट इंसर्शन ऑर्डर को रोकना या उसकी समयसीमा खत्म होना. साथ ही, उपयोगकर्ता सूचियों या अन्य टारगेटिंग का बंद होना.