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