ऑब्जेक्ट बदलना और उनकी जांच करना

जैसा कि एपीआई स्ट्रक्चर गाइड में बताया गया है, Google Ads API में हर टॉप-लेवल रिसॉर्स के लिए, संसाधन के टाइप के हिसाब से एक खास सेवा होती है. यह सेवा इन कामों में मदद करती है:

• संसाधन के इंस्टेंस में बदलाव करना
• जांच के लिए संसाधन का एक इंस्टेंस हासिल करना

इस गाइड में, Campaign ऑब्जेक्ट में बदलाव करने और उनकी जांच करने के लिए, CampaignService का इस्तेमाल किया जाएगा. हालांकि, ये सिद्धांत किसी खास संसाधन के हिसाब से बनी अन्य सभी सेवाओं पर लागू होते हैं.

ऑब्जेक्ट बदलना

हर संसाधन-टाइप खास सेवा में एक mutate तरीका होगा, जो बदलाव के अनुरोध को स्वीकार करता है. यह अनुरोध इसमें शामिल है:

• customerId
• कार्रवाइयों का कलेक्शन
• एक रिस्पॉन्स कॉन्टेंट टाइप सेटिंग, जो यह तय करती है कि बदलाव किए जा सकने वाले रिसॉर्स या सिर्फ़ रिसॉर्स का नाम, म्यूटेशन के बाद लौटाया जाना चाहिए या नहीं.

उदाहरण के लिए, CampaignService के MutateCampaigns तरीके से ऐसा MutateCampaignsRequest स्वीकार किया जाता है जिसमें ये चीज़ें शामिल होती हैं:

• customerId
• CampaignOperation ऑब्जेक्ट का संग्रह
• response_content_type फ़ील्ड, पसंदीदा जवाब के टाइप को दिखाता है.

ऑपरेशंस

CampaignOperation जैसे किसी कार्रवाई ऑब्जेक्ट की मदद से, किसी एक संसाधन पर operation फ़ील्ड सेट करके वह कार्रवाई तय की जा सकती है जो आपको करनी है. इस फ़ील्ड का एक फ़ील्ड है, जिसमें ये एट्रिब्यूट शामिल होते हैं. रिसॉर्स टाइप का टाइप:

create

रिसॉर्स का नया इंस्टेंस बनाता है.

update

update संसाधन की विशेषताओं से मिलान करने के लिए संसाधन को अपडेट करता है. यह फ़ील्ड सेट होने पर, आपको ऑपरेशन का update_mask भी सेट करना होगा. इससे Google Ads API को यह पता चलता है कि अपडेट की कार्रवाई के दौरान किन एट्रिब्यूट में बदलाव करना है. हर क्लाइंट लाइब्रेरी में एक सुविधा या हेल्पर तरीका होता है, जिससे आपके लिए update_mask जनरेट होगा. इसके बारे में हमारी क्लाइंट लाइब्रेरी में बताया गया है.

remove

संसाधन को हटाता है.

operation फ़ील्ड एक oneof फ़ील्ड है, इसलिए एक से ज़्यादा ऑब्जेक्ट में बदलाव करने के लिए, सिंगल ऑपरेशन का इस्तेमाल नहीं किया जा सकता. उदाहरण के लिए, अगर आपको एक कैंपेन बनाकर दूसरा कैंपेन हटाना है, तो अपने अनुरोध में CampaignOperation के दो इंस्टेंस जोड़ें: एक में create सेट है और दूसरा remove सेट के साथ.

बैच बनाने की कार्रवाइयां

हालांकि, एक कार्रवाई से सिर्फ़ एक संसाधन बनाया, अपडेट किया जा सकता है या हटाया जा सकता है. हालांकि, बदलाव के एक अनुरोध में कई कार्रवाइयां हो सकती हैं. आपको अपने ऑपरेशन को एक म्यूटेट अनुरोध को भेजने के बजाय, एक ही बदलाव के अनुरोध में जोड़ना चाहिए, जिसमें हर एक में एक ही बदलाव शामिल हो.

उदाहरण के लिए, अगर आपको दस कैंपेन बनाने हैं, तो आपको एक एक MutateCampaignsRequest भेजना चाहिए, जिसमें दस CampaignOperation ऑब्जेक्ट हों.

जवाबों को बदलें

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

बदलाव करने से जुड़ी गड़बड़ियां

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

get के साथ ऑब्जेक्ट की जांच करना (अब काम नहीं करता)

ऑब्जेक्ट बदलने के अलावा, हर तरह के संसाधन के लिए खास सेवा में किसी एक संसाधन के सभी एट्रिब्यूट को वापस पाने के लिए get तरीका भी होता है. इस तरीके से पाने का अनुरोध स्वीकार किया जाता है जिसका सिर्फ़ एट्रिब्यूट resource_name है.

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