इस पेज पर, एपीआई का इस्तेमाल करके सामान्य काम करने के तरीके के बारे में जानकारी दी गई है.
उपयोगकर्ता बनाना
UserService, ऐसा उपयोगकर्ता जिसके पास बनाए जाने का एडमिन अधिकार है उपयोगकर्ता सीधे उनके नेटवर्क में. कोई भी डेवलपर इसके बिना ऐसा कर सकता है सबसे पहले नए उपयोगकर्ता के लिए साइन अप करें. उदाहरण के लिए, अगर आप प्रत्येक API कॉल को व्यवस्थापक के रूप में करने के बजाय (डिफ़ॉल्ट आपके ईमेल पते के लिए), हो सकता है कि आप इस तरह की भूमिकाओं के साथ कुछ उपयोगकर्ता बनाना चाहें सेल्सपर्सन, ट्रैफ़िकर या विज्ञापन देने वाले लोग या कंपनियां, रीयल-वर्ल्ड वर्कफ़्लो की जांच कर सकती हैं.
- कुछ नए gmail पते बनाएं, जैसे कि
my.name.salesperson@gmail.com. इसके अलावा, किसी मौजूदा गैर-Gmail पते को एक नए Gmail पते के रूप में Google खाता. - उस नए पते और चुने गए
Roleके साथcreateUsersपर कॉल करें. - ऐक्सेस टोकन जनरेट करने के लिए, OAuth 2.0 का इस्तेमाल करके, उस नए उपयोगकर्ता की पुष्टि की जा सकती है.
रूट विज्ञापन यूनिट पाना
सबसे ऊपर मौजूद AdUnit, जिनमें चाइल्ड नोड जोड़े जा सकते हैं और क्रम में कितनी लेवल की अनुमति है, यह आपके खाता टाइप (छोटा कारोबार या प्रीमियम) पर निर्भर करता है. अपने चाइल्ड नोड में बदलाव करने की सुविधा देने वाले सबसे ऊपर के AdUnit को असरदार रूट AdUnit कहा जाता है.
असरदार रूट वापस पाने के लिए, NetworkService.getCurrentNetwork() को कॉल करें और लौटाए गए Network ऑब्जेक्ट पर effectiveRootAdUnitId फ़ील्ड की जांच करें.
ध्यान दें: अलग-अलग तरह के खातों के लिए, अलग-अलग हैरारकी पैटर्न इस्तेमाल किए जा सकते हैं.
किसी ऑब्जेक्ट के बारे में क्वेरी करना
getObjectsByStatement() तरीके का इस्तेमाल करके, खोज के हिसाब से ऑब्जेक्ट खोजे जाते हैं
कई सेवाओं के ज़रिए दिखाया जाता है, जहां ऑब्जेक्ट एक खास ऑब्जेक्ट टाइप है. यह
तरीका, PQL क्वेरी लेता है. यह एसक्यूएल क्वेरी की तरह ही होती है
खोजने के लिए फ़ील्ड (जहां फ़ील्ड के नाम ऑब्जेक्ट पर प्रॉपर्टी से मैप होते हैं), क्रम से लगाना,
सीमित करने और आपके खोज परिणामों को ऑफ़सेट करने में मदद करता है. PQL देखें
PQL के बारे में ज़्यादा जानने और यह जानने के लिए कि कौनसे ऑब्जेक्ट फ़ील्ड का इस्तेमाल किया जा सकता है,
फ़िल्टर करें.
ऑर्डर बनाना
ऑर्डर बनाने के लिए, Order ऑब्जेक्ट बनाएं और विज्ञापन देने वाले व्यक्ति या कंपनी को सेट करें.
और सही उपयोगकर्ताओं को ट्रैफ़िकर आईडी असाइन करते हैं.
और createOrders() पर कॉल करें. नतीजे में नया बनाया गया Order शामिल होगा,
या कोई गड़बड़ी हुई है.
उदाहरण
ऑर्डर बनाने के लिए JavaScript कोड का उदाहरण देखें.
लाइन आइटम बनाना
नया लाइन आइटम बनाने का तरीका यहां बताया गया है:
- एक नया
Orderऑब्जेक्ट बनाएं या किसी मौजूदा ऑब्जेक्ट का इस्तेमाल करें. - नया
LineItemऑब्जेक्ट बनाएं और रोटेशन टाइप, क्रिएटिव साइज़ अरे सेट करें. शुरू और खत्म होने की तारीख, और अन्य प्रॉपर्टी. - एक नया
InventoryTargetingऑब्जेक्ट बनाएं और बताएं कि कौनसेPlacementयाAdUnitऑब्जेक्ट को टारगेट करना है या बाहर रखना है. - अपने
InventoryTargetingऑब्जेक्ट को नएTargetingऑब्जेक्ट में रैप करें और असाइन करें इसे अपनीLineItemकी टारगेटिंग प्रॉपर्टी में जोड़ सकते हैं. - अपने नए ऑब्जेक्ट के साथ लाइन-आइटम सेवा तरीके
createLineItems()को कॉल करें और नतीजे की जांच करके देखें कि आपका ऑब्जेक्ट बनाया गया था या नहीं.
उदाहरण
लाइन आइटम बनाने के लिए Java कोड का उदाहरण देखें.
क्रिएटिव बनाना
अलग-अलग तरह के क्रिएटिव अलग-अलग कॉम्पोनेंट के साथ काम करते हैं: उदाहरण के लिए, इमेज
क्रिएटिव, इमेज के लिए एक ही सोर्स फ़ाइल का समर्थन करता हो; Flash क्रिएटिव समर्थन करता है
दो मूल ऐसेट फ़ाइलें: एक फ़्लैश फ़ाइल और एक बैकअप इमेज फ़ाइल, फ़्लैश होने की स्थिति में
फ़ाइल को सर्व नहीं किया जा सकता. तीसरे पक्ष की साइटों पर होस्ट किए गए क्रिएटिव के लिए, आपको
सिर्फ़ एक एचटीएमएल स्निपेट जो तीसरे पक्ष के सर्वर पर मौजूद फ़ाइल का रेफ़रंस देता है. अपने
खास Creative सब-क्लास के लिए, ताकि यह पता किया जा सके कि आपको किन ऐसेट को क्रम से अपलोड करना है
जिससे कि आप अपना क्रिएटिव कॉन्टेंट बना सकें.
उदाहरण
इमेज क्रिएटिव बनाने के लिए JavaScript कोड का उदाहरण देखें.
मौजूदा ऑब्जेक्ट में बदलाव करना
किसी मौजूदा ऑब्जेक्ट में बदलाव करने के लिए, getObjectsByStatement() पर कॉल करके अपने ऑब्जेक्ट से क्वेरी करें,
लौटाए गए ऑब्जेक्ट में वैल्यू को अपडेट करें. इसके बाद, updateObjects() को कॉल करें.
ध्यान दें: अपडेट किए गए ऑब्जेक्ट, मौजूदा ऑब्जेक्ट को पूरी तरह से बदल देंगे. इसलिए, अगर भेजे जाने वाले ऑब्जेक्ट में कोई प्रॉपर्टी वैल्यू सेट न करें, तो सेव किया गया ऑब्जेक्ट तो उस प्रॉपर्टी की डिफ़ॉल्ट वैल्यू पाएं, न कि पिछली वैल्यू.
ऑब्जेक्ट का स्टेटस बदलना
performObjectAction() तरीके को कॉल करने से ऑब्जेक्ट का स्टेटस बदल जाता है
बिना अनुमति के सार्वजनिक किए गए हैं. इस तरीके में दो पैरामीटर होते हैं:
- ऐक्शन ऑब्जेक्ट का एक इंस्टेंस, जो यह बताता है कि आपको क्या करवाना है. इसके लिए
उदाहरण के लिए, ऑर्डर सेवा में कई कार्रवाइयां दिखती हैं. इनमें
ApproveOrders,PauseOrders, औरArchiveOrders. ऐक्शन ऑब्जेक्ट, सभी बेस ऐक्शन से मिलते हैं आपकी सेवा के लिए उपयुक्त श्रेणी. - PQL क्वेरी, जो बताती है कि किन ऑब्जेक्ट में बदलाव करना है. इसे बदला जा सकता है सही PQL तय करके, एक बार में एक या उससे ज़्यादा ऑब्जेक्ट की स्थिति स्टेटमेंट का इस्तेमाल करें.
विज्ञापन टैग जनरेट करना
एपीआई का इस्तेमाल करके विज्ञापन टैग जनरेट नहीं किए जा सकते; तो आपको Google Ad Manager की वेबसाइट का इस्तेमाल करना होगा. ज़्यादा जानकारी के लिए, टैग करना ज़्यादा जानकारी देखें.
ज़्यादा उदाहरण
आपको हमारी क्लाइंट लाइब्रेरी के सैंपल कोड में, ऐसे कई और उदाहरण मिल सकते हैं जिनमें अलग-अलग प्रोग्रामिंग भाषाओं में कर सकते हैं. क्लाइंट लाइब्रेरी और उदाहरण कोड पेज पर, अपनी प्रोग्रामिंग भाषा में मौजूद उदाहरणों के लिंक पर जाएं.