गड़बड़ियां और चेतावनियां

Display & Video 360 API, कई तरह की गड़बड़ियों और चेतावनियों के साथ जवाब दे सकता है. एपीआई के सही समाधान के लिए, इन गड़बड़ियों को ठीक करना ज़रूरी है.

एपीआई से जुड़ी गड़बड़ियां

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

ध्यान दें: गड़बड़ियां दिखाने वाले अनुरोधों को कोटे में शामिल किया जाता है. एपीआई कोटे का बेहतर तरीके से इस्तेमाल करने के लिए, गड़बड़ी की दर कम करें.

एपीआई से जुड़ी गड़बड़ी के जवाब में, एचटीटीपी रिस्पॉन्स कोड, गड़बड़ी का मैसेज, और Google RPC कोड स्टेटस होता है. इसका फ़ॉर्मैट ऐसा होता है:

{
  "error": {
    "code": integer,
    "message": string,
    "status": enum (google.rpc.Code)
  }
}

यहां एपीआई से जुड़ी सामान्य गड़बड़ियों की सूची और उन्हें ठीक करने के तरीके दिए गए हैं:

ध्यान दें: अगर कार्रवाई करने के बाद भी गड़बड़ी बनी रहती है, तो सहायता टीम से संपर्क करें.

गड़बड़ी के कोड
400	INVALID_ARGUMENT आपकी अनुरोध में कोई समस्या है. गड़बड़ी के जवाब में मौजूद मैसेज फ़ील्ड की समीक्षा करें और अपने अनुरोध को उसके मुताबिक अपडेट करें.
401	UNAUTHENTICATED आपके अनुरोध की पुष्टि नहीं की जा सकी. पुष्टि करें कि आपने अपने अनुरोध में मान्य OAuth क्रेडेंशियल शामिल किए हों. ज़्यादा जानकारी के लिए, हमारी क्विकस्टार्ट गाइड देखें.
403	PERMISSION_DENIED आपके पास अनुरोध पूरा करने के लिए ज़रूरी अनुमतियां नहीं हैं. पुष्टि करें कि आपके उपयोगकर्ता खाते के पास, विज्ञापन देने वाले व्यक्ति या कंपनी या पार्टनर के लिए ज़रूरी अनुमतियां हों.
404	NOT_FOUND आपको जिस संसाधन को वापस पाना है वह नहीं मिल सका. पुष्टि करें कि इस्तेमाल किया जा रहा आईडी सही है और उस संसाधन टाइप के लिए है जिसे वापस पाया जा रहा है.
409	ABORTED जिस संसाधन में बदलाव करने की कोशिश की जा रही है उसमें किसी और जगह से बदलाव किया जा रहा है. कुछ सेकंड इंतज़ार करने के बाद, फिर से कोशिश करें.
429	RESOURCE_EXHAUSTED आपने अनुरोध संख्या सीमित करने की तय सीमा या हर दिन के लिए अनुरोधों का तय कोटा पार कर लिया है. एपीआई के इस्तेमाल की जानकारी देखने के लिए, Google Cloud Console का इस्तेमाल करें. मौजूदा कोटे की सीमाओं के अंदर काम करने के लिए, अपने वर्कफ़्लो को अपडेट करें. ज़्यादा जानकारी के लिए, इस्तेमाल को ऑप्टिमाइज़ करने से जुड़ी हमारी गाइड देखें.
500	INTERNAL एपीआई में कोई अंदरूनी गड़बड़ी हुई. कुछ सेकंड इंतज़ार करने के बाद, फिर से कोशिश करें. अगर गड़बड़ी बनी रहती है, तो सहायता टीम से संपर्क करें.
504	DEADLINE_EXCEEDED एपीआई को अनुरोध पूरा करने में बहुत ज़्यादा समय लगा. कुछ सेकंड इंतज़ार करने के बाद, फिर से कोशिश करें. अगर गड़बड़ी बनी रहती है, तो सहायता टीम से संपर्क करें.

एसडीएफ़ से जुड़ी गड़बड़ियां

Display & Video 360 API, स्ट्रक्चर्ड डेटा फ़ाइलें (एसडीएफ़) जनरेट करने के लिए, लंबे समय तक चलने वाले टास्क का इस्तेमाल करता है. एसडीएफ़ बनाते समय हुई गड़बड़ियों की जानकारी, पूरे हो चुके operation में दिखती है. error फ़ील्ड में यह जानकारी मौजूद होगी. काट-छांट करके बनाया गया यह उदाहरण देखें:

{
  ...
  "done": true,
  "error": {
    "code": 3,
    "message": "We couldn't prepare your CSV files: Invalid filter Ids for Advertiser: 00000000"
  }
}

अगर गड़बड़ी का मैसेज समझ में नहीं आ रहा है, तो हमारा सुझाव है कि आप ये काम करें:

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

अगर आपको अब भी गड़बड़ियां दिख रही हैं, तो सहायता टीम से संपर्क करें.

नॉन-ब्लॉकिंग चेतावनियां

विज्ञापन दिखाने पर असर न डालने वाली चेतावनियां, ऐसी समस्या के बारे में बताती हैं जिससे लाइन आइटम के विज्ञापन दिखाने पर असर पड़ सकता है. यूज़र इंटरफ़ेस (यूआई) में भी इसी तरह की चेतावनियां दिखती हैं. ये चेतावनियां, पैसिव होती हैं और लाइन आइटम में दिखती हैं.

चेतावनी की मुख्य वजह से, लाइन आइटम के दिखने पर असर पड़ सकता है. कुछ मामलों में, इससे विज्ञापन पूरी तरह से दिखने बंद हो सकते हैं.

रोकथाम

कुछ ऐसी चेतावनियां हैं जिनकी वजह से लाइन आइटम में कोई रुकावट नहीं आती. ये चेतावनियां, लाइन आइटम को गलत तरीके से कॉन्फ़िगर करने की वजह से दिखती हैं:

• फ़्लाइट: अगर किसी लाइन आइटम की फ़्लाइट अमान्य है या उसके इंसर्शन ऑर्डर की फ़्लाइट की समयसीमा खत्म हो गई है, तो वह विज्ञापन नहीं दिखाएगा. पक्का करें कि किसी लाइन आइटम का फ़्लाइट, उसके इंसर्शन ऑर्डर के फ़्लाइट के अंदर हो.
• असाइन किए गए क्रिएटिव: अगर किसी लाइन आइटम को मान्य क्रिएटिव असाइन नहीं किया गया है, तो वह नहीं दिखेगा.
• टारगेटिंग: अगर किसी लाइन आइटम के लिए टारगेटिंग को सही तरीके से असाइन नहीं किया गया है, तो विज्ञापन दिखाने पर असर पड़ सकता है या विज्ञापन पूरी तरह से बंद हो सकता है.

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

मॉनिटर करने के लिए

लाइन आइटम के चालू होने के दौरान, नॉन-ब्लॉकिंग चेतावनियां दिख सकती हैं. नई चेतावनियों के लिए, अपने चालू लाइन आइटम को मॉनिटर करें. इससे यह पक्का किया जा सकेगा कि वे सही तरीके से काम कर रहे हैं. list अनुरोध की मदद से, एक साथ कई लाइन आइटम पाएं. अगर किसी लाइन आइटम के लिए, अचानक कोई चेतावनी दिखती है, तो समस्या को जल्द से जल्द ठीक करें. इससे विज्ञापन दिखाने पर पड़ने वाले असर को कम किया जा सकेगा.

सेटिंग या टारगेटिंग में बदलाव न होने पर भी चेतावनियां जोड़ी जा सकती हैं. इसके उदाहरणों में ये शामिल हैं:

• इंसर्ट करने का क्रम रोका गया है या इसकी समयसीमा खत्म हो गई है.
• उपयोगकर्ता सूची या टारगेटिंग के विकल्प को बंद कर दिया गया है.