अपना पहला क्लाइंट ऐप्लिकेशन कोड करने से पहले, कुछ ऐसी चीज़ें हैं जिन्हें करना ज़रूरी है. खास तौर पर, जब आपने उन्हें पहले से नहीं किया है.
कोई Google खाता प्राप्त करें
Google API Console में प्रोजेक्ट बनाने के लिए, आपके पास Google खाता होना चाहिए. अगर आपके पास पहले से कोई खाता है, तो आप इसे इस्तेमाल करने के लिए तैयार हैं.
आपको जांच के लिए, अलग Google खाते की ज़रूरत भी पड़ सकती है.
Google की विज्ञापन अनुभव रिपोर्ट आज़माएं
इस एपीआई के दस्तावेज़ में यह माना गया है कि आपने Google Ad Experience Report का इस्तेमाल किया है. साथ ही, आपको वेब प्रोग्रामिंग के सिद्धांतों और वेब डेटा फ़ॉर्मैट के बारे में जानकारी है.
अगर आपने Google Ad Experience Report का इस्तेमाल नहीं किया है, तो कोडिंग शुरू करने से पहले यूज़र इंटरफ़ेस आज़माएं.
अपने क्लाइंट के लिए प्रोजेक्ट बनाना
Google Ad Experience Report को अनुरोध भेजने के लिए यह ज़रूरी है कि आप पहले Google को अपने क्लाइंट के बारे में बताएं. साथ ही, एपीआई इस्तेमाल करने की सुविधा चालू करें. ऐसा Google API Console से प्रोजेक्ट बनाने के लिए किया जाता है. यह सेटिंग और एपीआई के इस्तेमाल की जानकारी वाले ग्रुप का एक नाम है. साथ ही, अपना ऐप्लिकेशन रजिस्टर करें.
REST के बारे में बुनियादी जानकारी
एपीआई को दो तरीकों से कॉल किया जा सकता है:
- एचटीटीपी अनुरोध भेजना और जवाबों को पार्स करना.
- क्लाइंट लाइब्रेरी का इस्तेमाल करके.
अगर आपको क्लाइंट लाइब्रेरी का इस्तेमाल नहीं करना है, तो आपको REST के बारे में बुनियादी जानकारी होनी चाहिए.
REST, सॉफ़्टवेयर आर्किटेक्चर का एक स्टाइल है. यह डेटा में बदलाव करने और डेटा का अनुरोध करने का आसान और एक जैसा तरीका उपलब्ध कराता है.
REST, "Representational State Transfer" का छोटा नाम है. Google के एपीआई के संदर्भ में, इसका मतलब है कि Google के पास सेव किए गए डेटा को वापस पाने और उसमें बदलाव करने के लिए, एचटीटीपी वर्ब का इस्तेमाल करना.
RESTful सिस्टम में, संसाधनों को डेटा स्टोर में सेव किया जाता है. क्लाइंट, सर्वर को ऐसा अनुरोध भेजता है कि वह कोई खास कार्रवाई करे. जैसे, किसी संसाधन को बनाना, वापस पाना, अपडेट करना या मिटाना. इसके बाद, सर्वर वह कार्रवाई करता है और जवाब भेजता है. यह जवाब अक्सर, बताए गए संसाधन के तौर पर होता है.
Google के RESTful API में, क्लाइंट किसी कार्रवाई के लिए एचटीटीपी वर्ब का इस्तेमाल करता है. जैसे, POST, GET, PUT या DELETE. यह इस फ़ॉर्म में मौजूद, दुनिया भर में पहचाने जाने वाले यूआरआई के ज़रिए किसी संसाधन के बारे में बताता है:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
सभी एपीआई संसाधनों के पास एचटीटीपी से ऐक्सेस किए जा सकने वाले यूआरआई होते हैं. इसलिए, REST से डेटा को कैश मेमोरी में सेव किया जा सकता है. साथ ही, इसे वेब के डिस्ट्रिब्यूटेड इंफ़्रास्ट्रक्चर के साथ काम करने के लिए ऑप्टिमाइज़ किया जाता है.
आपको एचटीटीपी 1.1 के स्टैंडर्ड के दस्तावेज़ में, मेथड की परिभाषाएं मिल सकती हैं. इनमें GET, POST, PUT, और DELETE के लिए खास जानकारी शामिल है.
Google Ads के विज्ञापन अनुभव रिपोर्ट एपीआई में REST
Google Ad Experience Report API की कार्रवाइयां, सीधे तौर पर REST HTTP वर्ब से मैप होती हैं.
Google Ad Experience Report API के यूआरआई के लिए, ये फ़ॉर्मैट इस्तेमाल किए जाते हैं:
https://adexperiencereport.googleapis.com/v1/resourcePath?parameters
एपीआई में काम करने वाली हर सुविधा के लिए इस्तेमाल किए गए यूआरआई के पूरे सेट की खास जानकारी, Google Ad Experience Report API के रेफ़रंस दस्तावेज़ में दी गई है.
JSON के बारे में बुनियादी जानकारी
Google Ad Experience Report API, डेटा को JSON फ़ॉर्मैट में दिखाता है.
JSON (JavaScript Object Notation) एक सामान्य डेटा फ़ॉर्मैट है. यह किसी भी भाषा पर निर्भर नहीं करता. यह किसी भी डेटा स्ट्रक्चर को टेक्स्ट के तौर पर दिखाता है. ज़्यादा जानकारी के लिए, json.org पर जाएं.