एपीआई स्ट्रक्चर

ondemand_video अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है वीडियो: साल 2019 की वर्कशॉप में हुई सेवाओं और संसाधनों की जानकारी देखें

इस गाइड में उन मुख्य कॉम्पोनेंट के बारे में बताया गया है जो Google Ads API बनाते हैं. कॉन्टेंट बनाने Google Ads API में संसाधन और सेवाएं शामिल हैं. Google Ads के बारे में बताने वाला संसाधन इकाई मौजूद होती है, जबकि सेवाएं Google Ads इकाइयों को फिर से हासिल करती हैं और उनमें बदलाव करती हैं.

ऑब्जेक्ट की हैरारकी

Google Ads खाते को ऑब्जेक्ट की हैरारकी के तौर पर देखा जा सकता है.

• किसी खाते का शीर्ष-स्तरीय संसाधन customer.

• हर ग्राहक में एक या उससे ज़्यादा ऐक्टिव हैं कैंपेन.

• हर कैंपेन में एक या उससे ज़्यादा विज्ञापन ग्रुप होते हैं, जिनका इस्तेमाल किया जाता है लॉजिकल कलेक्शन में अपने विज्ञापनों को शामिल करने के लिए.

• विज्ञापन ग्रुप का विज्ञापन उस विज्ञापन को दिखाता है जिसे दौड़ने. उन ऐप्लिकेशन कैंपेन को छोड़कर जिनमें हर विज्ञापन में सिर्फ़ एक विज्ञापन ग्रुप का विज्ञापन हो सकता है समूह में, हर विज्ञापन समूह में एक या एक से ज़्यादा विज्ञापन समूह के विज्ञापन होते हैं.

एक या उससे ज़्यादा AdGroupCriterion अटैच किए जा सकते हैं या CampaignCriterion को विज्ञापन ग्रुप या कैंपेन बनाएं. ये शर्तें तय करती हैं कि विज्ञापन कैसे ट्रिगर होंगे.

मानदंड के कई टाइप होते हैं, जैसे कीवर्ड, आयु सीमा, और स्थान. कैंपेन में तय किए गए मानदंड स्तर अभियान के अन्य सभी संसाधनों को प्रभावित करता है. यह भी बताया जा सकता है कि पूरे कैंपेन के बजट और तारीखें.

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

संसाधन

संसाधन, आपके Google Ads खाते में मौजूद इकाइयों के बारे में बताते हैं. Campaign और AdGroup इसके दो उदाहरण हैं उसके संसाधनों का 50% हिस्सा है.

ऑब्जेक्ट आईडी

Google Ads में हर ऑब्जेक्ट की पहचान, उसके आईडी से की जाती है. इनमें से कुछ आईडी सभी Google Ads खातों में यूनीक होते हैं, जबकि दूसरे सिर्फ़ Google Ads खातों में यूनीक होते हैं एक सीमित दायरा.

Google Ads के लिए लोकल स्टोरेज डिज़ाइन करते समय, आईडी से जुड़े ये नियम काम के हो सकते हैं ऑब्जेक्ट हैं.

कुछ ऑब्जेक्ट, एक से ज़्यादा तरह की इकाइयों के लिए इस्तेमाल किए जा सकते हैं. ऐसे मामलों में, ऑब्जेक्ट इसमें type फ़ील्ड होता है, जो इसके कॉन्टेंट के बारे में बताता है. उदाहरण के लिए, AdGroupAd टेक्स्ट विज्ञापन जैसा कोई ऑब्जेक्ट बता सकता है, होटल विज्ञापन या स्थानीय विज्ञापन. इस वैल्यू को यहां से ऐक्सेस किया जा सकता है: AdGroupAd.ad.type फ़ील्ड में डाली जाती है और AdType सूची.

संसाधनों के नाम

हर संसाधन की पहचान एक resource_name स्ट्रिंग से की जाती है, जिसमें संसाधन और उसके पैरंट को एक पाथ में जोड़ता है. उदाहरण के लिए, कैंपेन संसाधन नाम इस रूप में होते हैं:

customers/customer_id/campaigns/campaign_id

इसलिए, ग्राहक आईडी वाले Google Ads खाते में, 987654 आईडी वाले कैंपेन के लिए 1234567, resource_name होगी:

customers/1234567/campaigns/987654

सेवाएं

सेवाओं की मदद से, Google Ads की इकाइयों को फिर से हासिल किया जा सकता है और उनमें बदलाव किया जा सकता है. इसके तीन टाइप हैं सेवाओं के: संशोधन, ऑब्जेक्ट और आंकड़े वापस पाना, और मेटाडेटा वापस पाना सेवाओं.

ऑब्जेक्ट में बदलाव करें (बदलाव करें)

ये सेवाएं, mutate का इस्तेमाल करके, इससे जुड़े संसाधन टाइप के इंस्टेंस में बदलाव करती हैं अनुरोध. वे एक संसाधन को हासिल करने वाला get अनुरोध भी देते हैं जो संसाधन की संरचना की जांच करने के लिए उपयोगी हो सकती है.

सेवाओं के उदाहरण:

• बदलाव करने के लिए CustomerService ग्राहक के तौर पर काम करते हैं.

• बदलाव करने के लिए CampaignService कैंपेन.

• विज्ञापन ग्रुप में बदलाव करने के लिए, AdGroupService.

mutate के हर अनुरोध में, उससे जुड़े operation ऑब्जेक्ट शामिल होने चाहिए. इसके लिए उदाहरण के लिए, CampaignService.MutateCampaigns तरीके में एक या एक से ज़्यादा CampaignOperation के इंस्टेंस. यहां जाएं: किसी ऑब्जेक्ट के लिए ऑब्जेक्ट बदलना और उनकी जांच करना प्रक्रियाओं पर विस्तार से चर्चा करें.

एक साथ बदलने वाले बदलाव

किसी Google Ads ऑब्जेक्ट में एक से ज़्यादा सोर्स से बदलाव नहीं किया जा सकता. यह अगर कई उपयोगकर्ता एक ही ऑब्जेक्ट को अपडेट कर रहे हैं, तो इससे गड़बड़ी हो सकती है या यदि आप एकाधिक फ़ाइलों का उपयोग करके समानांतर Google Ads ऑब्जेक्ट थ्रेड. इसमें एक ही थ्रेड में कई थ्रेड से ऑब्जेक्ट को अपडेट करना शामिल है या अलग-अलग ऐप्लिकेशन से (उदाहरण के लिए, आपका ऐप्लिकेशन और एक साथ Google Ads यूज़र इंटरफ़ेस (यूआई) सेशन).

एपीआई अपडेट करने से पहले, किसी ऑब्जेक्ट को लॉक करने का तरीका नहीं बताता; अगर दो सोर्स किसी ऑब्जेक्ट को साथ-साथ म्यूट करने की कोशिश करते हैं, तो एपीआई DatabaseError.CONCURRENT_MODIFICATION_ERROR.

एसिंक्रोनस बनाम सिंक्रोनस म्यूटेट

Google Ads API में बदलाव करने के तरीके सिंक्रोनस होते हैं. एपीआई कॉल से सिर्फ़ जवाब मिलता है ऑब्जेक्ट के बदल जाने के बाद, आपको हर एक के जवाब का इंतज़ार करना होगा अनुरोध. हालांकि, यह तरीका कोड के लिए करीब-करीब आसान है, लेकिन यह अगर प्रोसेस को असंतुलन बनाना पड़ता है, तो कॉल पूर्ण होने की इंतज़ार करें.

इसका एक वैकल्पिक तरीका यह है कि BatchJobService, जो कई सेवाओं पर कार्रवाइयां करने के लिए. एक बार बैच जॉब सबमिट किया जाता है, तो Google Ads API के सर्वर एसिंक्रोनस तरीके से ऑपरेशन करते हैं, अन्य कार्रवाइयों के लिए प्रोसेस को स्वतंत्र करना. आप समय-समय पर नौकरी के पूरा होने की स्थिति.

ज़्यादा जानकारी के लिए, बैच प्रोसेसिंग गाइड देखें एसिंक्रोनस प्रोसेसिंग.

पुष्टि करने की प्रक्रिया बदलें

ज़्यादातर म्यूटेट अनुरोधों की पुष्टि, कॉल को एक्ज़ीक्यूट किए बिना की जा सकती है और असली डेटा को इकट्ठा नहीं किया जाता. अनुरोध में पैरामीटर के मौजूद न होने और गलत पैरामीटर का पता लगाने के लिए, उसकी जांच की जा सकती है असल में कार्रवाई को एक्ज़ीक्यूट किए बिना फ़ील्ड वैल्यू को शामिल करता है.

इस सुविधा का इस्तेमाल करने के लिए, अनुरोध की वैकल्पिक validate_only बूलियन फ़ील्ड को इस पर सेट करें true. उसके बाद उस अनुरोध की पूरी तरह से पुष्टि की जाएगी, जैसे कि उसे एक्ज़ीक्यूट किया गया, लेकिन आखिरी बार एक्ज़ीक्यूट नहीं किया गया. अगर कोई गड़बड़ी नहीं मिलती है, तो एक खाली जवाब दिया गया. अगर पुष्टि नहीं हो पाती है, तो जवाब में गड़बड़ी के मैसेज दिखेंगे फ़ेलियर पॉइंट बताते हैं.

validate_only, खास तौर पर सामान्य नीति के तहत बनाए गए विज्ञापनों की जांच करने में फ़ायदेमंद है उल्लंघन. अगर विज्ञापन, इस तरह की नीतियों का उल्लंघन करते हैं, तो उन्हें अपने-आप अस्वीकार कर दिया जाता है जिनमें खास शब्द, विराम चिह्न, कैपिटल लेटर का इस्तेमाल या लंबाई हो. एक खराब विज्ञापन पूरा बैच फ़ेल हो सकता है. validate_only में नए विज्ञापन को टेस्ट करना अनुरोध से इस तरह के उल्लंघन के बारे में पता चल सकता है. हैंडलिंग के बारे में जानने के लिए कोड का उदाहरण देखें नीति के उल्लंघन से जुड़ी गड़बड़ियां देखें को भी शामिल किया गया है.

ऑब्जेक्ट और उनकी परफ़ॉर्मेंस के आंकड़े पाएं

GoogleAdsService एक सिंगल और यूनिफ़ाइड फ़ॉर्मैट है ऑब्जेक्ट और परफ़ॉर्मेंस के आंकड़े वापस पाने की सेवा.

GoogleAdsService के लिए सभी Search और SearchStream अनुरोधों के लिए एक ऐसी क्वेरी होनी चाहिए जो से जुड़ी क्वेरी, संसाधन एट्रिब्यूट और परफ़ॉर्मेंस मेट्रिक को फिर से हासिल करना, अनुरोध को फ़िल्टर करने के लिए इस्तेमाल करता है और आगे की प्रोसेस के लिए इस्तेमाल किए जाने वाले सेगमेंट में परफ़ॉर्मेंस के आंकड़ों का विश्लेषण किया जा सकता है. क्वेरी फ़ॉर्मैट के बारे में ज़्यादा जानकारी के लिए, Google Ads क्वेरी की भाषा की गाइड देखें.

मेटाडेटा वापस पाना

GoogleAdsFieldService, डेटा हासिल करता है Google Ads API में मौजूद संसाधनों से जुड़ा मेटाडेटा, जैसे कि संसाधन और उसका डेटा टाइप क्या है.

यह सेवा, क्वेरी बनाने के लिए ज़रूरी जानकारी उपलब्ध कराती है. GoogleAdsService. सुविधा के लिए, के ज़रिए मिली जानकारी GoogleAdsFieldService भी उपलब्ध है फ़ील्ड संदर्भ दस्तावेज़ में दी गई हो.