आम तौर पर होने वाली गड़बड़ियां

इस गाइड में, एपीआई से जुड़ी आम गड़बड़ियों के बारे में बताया गया है. साथ ही, इन गड़बड़ियों को रोकने और इनसे निपटने के तरीके भी बताए गए हैं.

गड़बड़ी के सभी टाइप की पूरी सूची देखने के लिए, Google Ads API की गड़बड़ी के रेफ़रंस देखें. अगर आपको और मदद चाहिए, तो Google Ads API के फ़ोरम पर कोई सवाल पूछें.

google.rpc.ErrorInfo

ACCESS_TOKEN_SCOPE_INSUFFICIENT
खास जानकारीOAuth 2.0 के ऐक्सेस टोकन में, ज़रूरी स्कोप नहीं हैं.
आम वजहें अनुरोध अस्वीकार कर दिया गया है, क्योंकि दिए गए ऐक्सेस टोकन में Google Ads API OAuth 2.0 का स्कोप शामिल नहीं है.
इसे कैसे ठीक करें पक्का करें कि ऐक्सेस टोकन में ज़रूरी स्कोप शामिल हों. इस गड़बड़ी की एक आम वजह यह है कि आपने किसी ऐसे मौजूदा ऐक्सेस टोकन का फिर से इस्तेमाल किया है जिसे OAuth स्कोप के किसी दूसरे सेट का इस्तेमाल करके जनरेट किया गया था. ज़रूरी स्कोप वाला नया ऐक्सेस टोकन जनरेट करने का तरीका जानने के लिए, OAuth ऑथराइज़ेशन के पैरामीटर देखें.
कोरोना वायरस की रोकथाम के लिए सलाह पक्का करें कि ऐक्सेस टोकन में ज़रूरी स्कोप शामिल हों. ज़रूरी स्कोप वाला ऐक्सेस पाने के लिए, अपने उपयोगकर्ता की फिर से पुष्टि करें. अगर आपका ऐप्लिकेशन, OAuth के एक से ज़्यादा स्कोप का इस्तेमाल करता है, तो आपको OAuth की ज़्यादा अनुमतियां लागू करनी पड़ सकती हैं.

google.auth.exceptions.RefreshError

invalid_grant
खास जानकारीटोकन की समयसीमा खत्म हो गई है या उसे रद्द कर दिया गया है.
आम वजहें Google Cloud Platform के किसी ऐसे प्रोजेक्ट के लिए रीफ़्रेश टोकन जारी किया जाता है जिसमें OAuth के लिए सहमति देने वाली स्क्रीन, बाहरी उपयोगकर्ता के टाइप के लिए कॉन्फ़िगर की गई हो और जिसकी पब्लिशिंग की स्थिति Testing हो. इस टोकन की समयसीमा सात दिनों में खत्म हो जाती है.
इसे कैसे ठीक करें आपके Google प्रोजेक्ट की पब्लिशिंग की स्थिति Testing है. इसलिए, रीफ़्रेश टोकन की समयसीमा हर सात दिनों में खत्म हो जाती है और आपको invalid_grant गड़बड़ी दिखती है. Google API Console पर जाएं और OAuth के लिए सहमति देने वाली स्क्रीन पर जाएं. इसके बाद, पब्लिशिंग की स्थिति को In production में बदलें, ताकि रीफ़्रेश टोकन की समयसीमा सात दिनों में खत्म न हो.
कोरोना वायरस की रोकथाम के लिए सलाह ऐसे ऐप्लिकेशन के बारे में जानकारी जिनकी पुष्टि नहीं की गई है लेख देखें.

AuthenticationError

CLIENT_CUSTOMER_ID_INVALID
खास जानकारीक्लाइंट का ग्राहक आईडी, कोई संख्या नहीं है.
आम वजहें क्लाइंट के ग्राहक आईडी का गलत इस्तेमाल करना.
इसे कैसे ठीक करें लागू नहीं
कोरोना वायरस की रोकथाम के लिए सलाह 123-456-7890 को 1234567890 होना चाहिए. ज़्यादा जानकारी के लिए, शुरू करें लेख पढ़ें.
CLIENT_CUSTOMER_ID_IS_REQUIRED
खास जानकारीएचटीटीपी हेडर में, क्लाइंट का ग्राहक आईडी नहीं बताया गया था.
आम वजहें एचटीटीपी हेडर में, क्लाइंट का ग्राहक आईडी न बताना.
इसे कैसे ठीक करें लागू नहीं
कोरोना वायरस की रोकथाम के लिए सलाह सभी कॉल के लिए, क्लाइंट का ग्राहक आईडी ज़रूरी है. इसलिए, पक्का करें कि आपने एचटीटीपी हेडर में यह आईडी बताया हो. हमारी क्लाइंट लाइब्रेरी का इस्तेमाल करने पर विचार करें, क्योंकि ये आपके लिए यह काम करती हैं.
CUSTOMER_NOT_FOUND
खास जानकारीहेडर में दिए गए ग्राहक आईडी के लिए कोई खाता नहीं मिला.
आम वजहें किसी ऐसे खाते को ऐक्सेस करने की कोशिश करना जिसे बैकएंड में सेट अप करने से ठीक पहले बनाया गया हो.
इसे कैसे ठीक करें शुरुआत में पांच मिनट इंतज़ार करें. इसके बाद, हर 30 सेकंड में फिर से कोशिश करें.
कोरोना वायरस की रोकथाम के लिए सलाह खाता बनाने के बाद, कुछ मिनट इंतज़ार करें. इसके बाद ही, उसके ख़िलाफ़ अनुरोध जारी करें.
खास जानकारीअनुरोध के हेडर में मौजूद ऐक्सेस टोकन अमान्य है या उसकी समयसीमा खत्म हो गई है.
आम वजहें ऐक्सेस टोकन अमान्य कर दिया गया है.
इसे कैसे ठीक करें नए टोकन का अनुरोध करें. अगर हमारी किसी क्लाइंट लाइब्रेरी का इस्तेमाल किया जा रहा है, तो टोकन को रीफ़्रेश करने का तरीका जानने के लिए, उसके दस्तावेज़ देखें.
कोरोना वायरस की रोकथाम के लिए सलाह ऐक्सेस टोकन को तब तक स्टोर करें और उनका फिर से इस्तेमाल करें, जब तक उनकी समयसीमा खत्म नहीं हो जाती.
NOT_ADS_USER
खास जानकारीऐक्सेस टोकन जनरेट करने के लिए इस्तेमाल किया गया Google खाता, किसी भी Google Ads खाते से जुड़ा नहीं है.
आम वजहें दी गई लॉगिन जानकारी, किसी ऐसे Google खाते से जुड़ी है जिसमें Google Ads की सुविधा चालू नहीं है.
इसे कैसे ठीक करें OAuth फ़्लो के लिए, किसी मान्य Google Ads खाते (आम तौर पर, आपका मैनेजर खाता) से साइन इन करें. आपके पास Google खाते को, किसी मौजूदा Google Ads खाते को ऐक्सेस करने का न्योता भेजने का विकल्प भी है. इसके लिए, अपने मैनेजर खाते में साइन इन करें. इसके बाद, उस ग्राहक या मैनेजर खाते को चुनें जिसके बारे में सवाल पूछा गया है. फिर, Tools and Settings > Access and security पर जाएं. इसके बाद, Google खाते का ईमेल पता जोड़ें.
कोरोना वायरस की रोकथाम के लिए सलाह लागू नहीं
OAUTH_TOKEN_INVALID
खास जानकारीहेडर में मौजूद OAuth ऐक्सेस टोकन मान्य नहीं है.
आम वजहें एचटीटीपी हेडर के साथ पास किया गया आपका ऐक्सेस टोकन सही नहीं था.
इसे कैसे ठीक करें लागू नहीं
कोरोना वायरस की रोकथाम के लिए सलाह पक्का करें कि आपने अपने खाते से जुड़ा सही ऐक्सेस टोकन पास किया हो. कभी-कभी इसे रीफ़्रेश टोकन और ऑथराइज़ेशन कोड के साथ भ्रमित कर दिया जाता है. अगर आपको ऐसा क्रेडेंशियल चाहिए जिससे किसी मैनेजर खाते के तहत मौजूद सभी क्लाइंट खातों को ऐक्सेस किया जा सके, तो पक्का करें कि आपको मैनेजर खाते के लिए रीफ़्रेश टोकन मिले. उपयोगकर्ता की पुष्टि करने के लिए बनी गाइड देखें.

AuthorizationError

CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION
खास जानकारीGoogle Cloud प्रोजेक्ट के पास सिर्फ़ टेस्ट ऐक्सेस है. इसका इस्तेमाल, प्रोडक्शन खातों को ऐक्सेस करने के लिए नहीं किया जा सकता.
आम वजहें टेस्ट ऐक्सेस लेवल वाले Google Cloud प्रोजेक्ट का इस्तेमाल, टेस्ट के लिए नहीं बने (प्रोडक्शन) Google Ads खाते के ख़िलाफ़ अनुरोध करने के लिए किया गया. (एपीआई के v24 और इससे पहले के वर्शन में, इस स्थिति में AuthorizationError.ACTION_NOT_PERMITTED गड़बड़ी दिखती है.)
इसे कैसे ठीक करें अगर टेस्ट किया जा रहा है, तो पक्का करें कि आपका अनुरोध किसी टेस्ट खाते को टारगेट करे. अगर आपको किसी प्रोडक्शन Google Ads खाते को ऐक्सेस करना है, तो Google Ads API की खास जानकारी वाले पेज पर, अपने Google Cloud प्रोजेक्ट का ऐक्सेस लेवल देखें. साथ ही, अपने प्रोजेक्ट के ऐक्सेस लेवल को एक्सप्लोरर, बेसिक या स्टैंडर्ड ऐक्सेस में अपग्रेड करें.
कोरोना वायरस की रोकथाम के लिए सलाह लागू नहीं
CUSTOMER_NOT_ENABLED
खास जानकारीग्राहक खाते को ऐक्सेस नहीं किया जा सकता, क्योंकि यह चालू नहीं है.
आम वजहें ऐसा तब होता है, जब ग्राहक खाते के लिए साइन अप की प्रोसेस पूरी नहीं की गई हो या उसे बंद कर दिया गया हो.
इसे कैसे ठीक करें Google Ads के यूज़र इंटरफ़ेस (यूआई) में साइन इन करें और पक्का करें कि आपने इस खाते के लिए साइन अप की प्रोसेस पूरी कर ली हो. बंद किए गए खातों के लिए, बंद किए गए Google Ads खाते को फिर से चालू करना लेख देखें.
कोरोना वायरस की रोकथाम के लिए सलाह ग्राहक खाते के बंद होने की स्थिति को, CANCELLED की स्थिति की जांच करके पहले से ही देखा जा सकता है.
USER_PERMISSION_DENIED
खास जानकारीजिस ग्राहक को अनुमति दी गई है उसके पास, काम करने वाले ग्राहक का ऐक्सेस नहीं है.
आम वजहें किसी ऐसे उपयोगकर्ता के तौर पर पुष्टि करना जिसके पास मैनेजर खाते का ऐक्सेस है, लेकिन अनुरोध में login-customer-id की जानकारी न देना.
इसे कैसे ठीक करें लागू नहीं
कोरोना वायरस की रोकथाम के लिए सलाह login-customer-id को, हाइफ़न (-) के बिना मैनेजर खाते के आईडी के तौर पर बताएं. क्लाइंट लाइब्रेरी में इसके लिए पहले से ही सहायता मौजूद है.