Google Ads API इंटिग्रेशन को सफल बनाने के लिए, टेस्टिंग एक अहम चरण है. भले ही, आपने अभी-अभी शुरुआत की हो, कोई ऐप्लिकेशन मैनेज कर रहे हों या मौजूदा इंटिग्रेशन में नई सुविधाएं जोड़ रहे हों. इस गाइड में, Google Ads API इंटिग्रेशन की टेस्टिंग के लिए कुछ सबसे सही तरीके बताए गए हैं.
टेस्ट खाते और प्रोडक्शन खाते
टेस्ट खाते, डेवलपमेंट के मकसद से उपलब्ध होते हैं. टेस्ट खातों की मदद से, यह पुष्टि की जा सकती है कि आपके ऐप्लिकेशन कोड और कॉन्फ़िगरेशन, उम्मीद के मुताबिक काम कर रहे हैं.
हालांकि, टेस्ट खाते में सभी सुविधाओं की जांच नहीं की जा सकती.
अगर टेस्ट खाते की सीमाओं की वजह से, इंटिग्रेशन में कुछ सुविधाओं की जांच नहीं की जा सकती, तो डेवलपमेंट के लिए प्रोडक्शन खाते का इस्तेमाल किया जा सकता है. किसी प्रोडक्शन खाते को कॉल करने के लिए, आपके
Google Cloud प्रोजेक्ट का ऐक्सेस लेवल कम से कम
एक्सप्लोरर (एक्सप्लोरर, बेसिक या स्टैंडर्ड) होना चाहिए. ध्यान दें कि एक्सप्लोरर ऐक्सेस से भी कुछ
सेवाओं पर पाबंदी लगती है. इनमें बिलिंग (BillingSetupService
और AccountBudgetProposalService),
प्लान बनाना, खाता बनाना, और उपयोगकर्ताओं को न्योते भेजना शामिल हैं. (एक्सप्लोरर की सुविधा पर लगी
पाबंदियां देखें). इन सेवाओं के लिए, बेसिक या स्टैंडर्ड
ऐक्सेस की ज़रूरत होती है. टेस्ट ऐक्सेस लेवल वाले किसी
प्रोजेक्ट से प्रोडक्शन खाते को कॉल करने की कोशिश करने पर,
AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION
v25 से, गड़बड़ी दिखती है. वहीं,
AuthorizationError.ACTION_NOT_PERMITTED v24 और
इससे पहले के वर्शन में, गड़बड़ी दिखती है.
डेवलपमेंट के लिए इस्तेमाल किए जाने वाले प्रोडक्शन खाते, टेस्ट खातों से इन मामलों में अलग होते हैं:
- इनसे ऐसे विज्ञापन दिखाए जा सकते हैं जो उपयोगकर्ताओं को दिखते हैं
- इनके लिए मान्य यूआरएल की ज़रूरत होती है
- इन्हें विज्ञापन दिखाने से जुड़ी नीतियों के मुताबिक होना चाहिए
प्रोडक्शन खातों से विज्ञापन दिखाए जाते हैं. इसलिए, इनसे मेट्रिक जनरेट होती हैं. इनकी मदद से, परफ़ॉर्मेंस रिपोर्ट की जांच की जा सकती है. साथ ही, 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 API को अनुरोध भेजने के लिए, curl का इस्तेमाल करने का तरीका जानने के लिए, REST उदाहरण देखें. इसके अलावा, REST एक्सप्लोरर में भी टेस्टिंग करें.