Google Ads API इंटिग्रेशन को सफल बनाने के लिए, टेस्टिंग एक अहम चरण है. भले ही, आपने अभी शुरुआत की हो, किसी ऐप्लिकेशन को मैनेज किया जा रहा हो या किसी मौजूदा इंटिग्रेशन में नई सुविधाएं जोड़ी जा रही हों. इस गाइड में, Google Ads API इंटिग्रेशन की जांच करने के कुछ सबसे सही तरीके बताए गए हैं.
टेस्ट खाते और प्रोडक्शन खाते
डेवलपमेंट के लिए, टेस्ट खाते उपलब्ध हैं. टेस्ट खातों की मदद से, यह पुष्टि की जा सकती है कि आपके ऐप्लिकेशन कोड और कॉन्फ़िगरेशन, उम्मीद के मुताबिक काम कर रहा है या नहीं.
हालांकि, टेस्ट खाते में सभी सुविधाओं की जांच नहीं की जा सकती.
अगर टेस्ट खाते की सीमाओं की वजह से, इंटिग्रेशन में कुछ सुविधाओं की जांच नहीं की जा सकती, तो डेवलपमेंट के लिए प्रोडक्शन खाते का इस्तेमाल किया जा सकता है. प्रोडक्शन खाते को कॉल करने के लिए, आपके Google Cloud प्रोजेक्ट के पास कम से कम एक्सप्लोरर ऐक्सेस लेवल (एक्सप्लोरर, बेसिक या स्टैंडर्ड) होना चाहिए. ध्यान दें कि एक्सप्लोरर ऐक्सेस होने पर भी कुछ सेवाओं पर पाबंदी लगी रहती है. जैसे, बिलिंग (BillingSetupService और AccountBudgetProposalService), प्लानिंग, खाता बनाना, और उपयोगकर्ताओं को न्योता भेजना. इन सेवाओं के लिए, बेसिक या स्टैंडर्ड ऐक्सेस की ज़रूरत होती है. एक्सप्लोरर ऐक्सेस की सुविधाओं पर लगी पाबंदियां देखें. टेस्ट ऐक्सेस लेवल वाले प्रोजेक्ट से प्रोडक्शन खाते को कॉल करने पर, v25 से शुरू होने वाले AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION या v24 और इससे पहले के AuthorizationError.ACTION_NOT_PERMITTED दिखते हैं.
डेवलपमेंट के लिए इस्तेमाल किए जाने वाले प्रोडक्शन खाते, टेस्ट खातों से इन तरीकों से अलग होते हैं:
- ऐसे विज्ञापन दिखाएं जो उपयोगकर्ताओं को दिखें
- मान्य यूआरएल ज़रूरी हैं
- विज्ञापन नीतियों के मुताबिक होना चाहिए
प्रोडक्शन खाते, विज्ञापन दिखाते हैं. इसलिए, वे मेट्रिक जनरेट करते हैं. इनकी मदद से, परफ़ॉर्मेंस रिपोर्ट को टेस्ट किया जा सकता है. साथ ही, Google Ads API की अन्य सभी सुविधाएं अनलॉक की जा सकती हैं. हालांकि, डेवलपमेंट के लिए इनका इस्तेमाल करते समय ज़्यादा सावधानी बरतनी चाहिए. हमारा सुझाव है कि आप ये काम करें:
- सिर्फ़ उन उपयोगकर्ताओं को ऐक्सेस दें जिन्हें डेवलपमेंट के लिए इसकी ज़रूरत है.
- खाते का रोज़ का बजट कम और तय रखें.
- डेवलपमेंट के लिए प्रोडक्शन खातों का इस्तेमाल सिर्फ़ तब करें, जब टेस्ट खातों का इस्तेमाल न किया जा सके.
इसलिए, अपने इंटिग्रेशन की पूरी जांच करने के लिए, आपको टेस्ट क्रेडेंशियल और प्रोडक्शन क्रेडेंशियल, दोनों की ज़रूरत पड़ सकती है.
जांच करने के लिए क्रेडेंशियल
डेवलपमेंट खातों में बदलाव करते समय, प्रोडक्शन खातों में गलती से बदलाव होने के जोखिम को कम करने के लिए, हमारा सुझाव है कि आप टेस्ट क्रेडेंशियल का एक सेट बनाएं. यह सेट, आपके प्रोडक्शन ऐप्लिकेशन के क्रेडेंशियल से अलग होना चाहिए.
टेस्ट क्रेडेंशियल का सेट बनाने के लिए, यह तरीका अपनाएं:
- कोई ईमेल खाता (उदाहरण के लिए,
api.test@example.com) या सेवा खाता बनाएं, जिसका इस्तेमाल सिर्फ़ टेस्टिंग के लिए किया जाएगा. - इस उपयोगकर्ता या सेवा खाते को उन Google Ads खातों में मान्य उपयोगकर्ता के तौर पर जोड़ें जिनमें आपको टेस्ट चलाने हैं. पक्का करें कि आपने इस उपयोगकर्ता या सेवा खाते को सही ऐक्सेस लेवल दिया हो. इस उपयोगकर्ता या सेवा खाते को किसी भी प्रोडक्शन खाते का ऐक्सेस न दें.
- अगर सेवा खाते के फ़्लो के बजाय, OAuth 2.0 उपयोगकर्ता की पुष्टि करने वाले फ़्लो का इस्तेमाल किया जा रहा है, तो टेस्ट उपयोगकर्ता खाते के लिए रीफ़्रेश टोकन जनरेट करें.
- अपने ऐप्लिकेशन की जांच करते समय, इन नए क्रेडेंशियल का इस्तेमाल करें. क्लाइंट आईडी और क्लाइंट सीक्रेट को टेस्टिंग के लिए फिर से इस्तेमाल किया जा सकता है. ऐसा इसलिए, क्योंकि इनसे यह तय नहीं होता कि किन Google Ads खातों को ऐक्सेस किया जा सकता है. सभी क्रेडेंशियल और रीफ़्रेश टोकन को सुरक्षित तरीके से सेव करें. साथ ही, उन्हें सोर्स कंट्रोल में कभी भी कमिट न करें.
सत्यापन का अनुरोध करें
अगर आपको सिर्फ़ यह जांच करनी है कि कोई अनुरोध मान्य है या नहीं, तो validate_only फ़ील्ड का इस्तेमाल करें. उदाहरण के लिए, यह पुष्टि करने के लिए कि अनुरोध सही तरीके से स्ट्रक्चर्ड है और नीतियों का उल्लंघन नहीं करता है. यह फ़ील्ड, GoogleAdsService.Search अनुरोधों और बदलाव के ज़्यादातर अनुरोधों के लिए उपलब्ध है. ध्यान दें कि GoogleAdsService.SearchStream, validate_only के साथ काम नहीं करता. रेफ़रंस दस्तावेज़ देखें और पुष्टि करें कि यह फ़ील्ड किसी तरीके के लिए उपलब्ध है या नहीं.
REST API
किसी खास मकसद से टेस्टिंग करने के लिए, REST API का इस्तेमाल करना अक्सर सबसे आसान विकल्प होता है. जैसे, यह पुष्टि करना कि किसी अनुरोध से उम्मीद के मुताबिक आउटपुट मिलता है या नहीं. REST के उदाहरण देखें. इनसे आपको REST API को अनुरोध भेजने के लिए, curl का इस्तेमाल करने का तरीका पता चलेगा. REST एक्सप्लोरर में भी टेस्ट करके देखें.