टेस्ट करना

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 की अन्य सभी सुविधाओं को अनलॉक किया जा सकता है. हालांकि, डेवलपमेंट के लिए इनका इस्तेमाल करते समय ज़्यादा सावधानी बरतनी चाहिए. हमारा सुझाव है कि आप ये तरीके अपनाएं:

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

इसलिए, इंटिग्रेशन की पूरी जांच करने के लिए, आपको टेस्ट क्रेडेंशियल और प्रोडक्शन क्रेडेंशियल, दोनों की ज़रूरत पड़ सकती है.

जांच करने के लिए क्रेडेंशियल

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

टेस्ट क्रेडेंशियल का सेट बनाने के लिए, यह तरीका अपनाएं:

  1. एक ईमेल खाता (उदाहरण के लिए, api.test@example.com) या सेवा खाता बनाएं. इसका इस्तेमाल सिर्फ़ टेस्टिंग के लिए किया जाएगा.
  2. इस उपयोगकर्ता या सेवा खाते को उन Google Ads खातों में मान्य उपयोगकर्ता के तौर पर जोड़ें जिनके ख़िलाफ़ आपको टेस्ट चलाने हैं. पक्का करें कि आपने इस उपयोगकर्ता या सेवा खाते को सही ऐक्सेस लेवल दिया हो. इस उपयोगकर्ता या सेवा खाते को किसी भी प्रोडक्शन खाते का ऐक्सेस न दें.
  3. अगर सेवा खाते के फ़्लो के बजाय, OAuth 2.0 उपयोगकर्ता की पुष्टि करने का फ़्लो इस्तेमाल किया जा रहा है, तो अपने टेस्ट उपयोगकर्ता खाते के लिए रीफ़्रेश टोकन जनरेट करें.
  4. अपने ऐप्लिकेशन की टेस्टिंग के दौरान, इन नए क्रेडेंशियल का इस्तेमाल करें. क्लाइंट आईडी और क्लाइंट सीक्रेट का इस्तेमाल टेस्टिंग के लिए फिर से किया जा सकता है. ऐसा इसलिए, क्योंकि इनसे यह तय नहीं होता कि किन Google Ads खातों को ऐक्सेस किया जा सकता है. सभी क्रेडेंशियल और रीफ़्रेश टोकन को सुरक्षित तरीके से सेव करें. साथ ही, उन्हें कभी भी सोर्स कंट्रोल में न डालें.

सत्यापन का अनुरोध करें

अगर आपको सिर्फ़ यह जांच करनी है कि अनुरोध मान्य है या नहीं, तो validate_only फ़ील्ड का इस्तेमाल करें. उदाहरण के लिए, यह पुष्टि करने के लिए कि अनुरोध सही तरीके से स्ट्रक्चर किया गया है और नीतियों का उल्लंघन नहीं करता है. यह फ़ील्ड, GoogleAdsService.Search अनुरोधों (ध्यान दें कि GoogleAdsService.SearchStream, validate_only के साथ काम नहीं करता) और ज़्यादातर म्यूटेट अनुरोधों के लिए उपलब्ध है. रेफ़रंस दस्तावेज़ देखें. इससे यह पुष्टि की जा सकेगी कि यह फ़ील्ड किसी दिए गए तरीके के लिए उपलब्ध है या नहीं.

REST API

एड हॉक टेस्टिंग के लिए, REST API का इस्तेमाल करना सबसे आसान विकल्प होता है. उदाहरण के लिए, यह पुष्टि करने के लिए कि किसी अनुरोध से उम्मीद के मुताबिक आउटपुट मिला है. REST API को अनुरोध भेजने के लिए, curl का इस्तेमाल करने का तरीका जानने के लिए, REST के उदाहरण देखें. इसके अलावा, REST एक्सप्लोरर में भी जांच करके देखें.