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

मकसद: Google Ads API का इस्तेमाल करके, ऑब्जेक्ट में बदलाव करने का तरीका जानें.

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

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

मुख्य शब्द: टॉप-लेवल रिसॉर्स, ऐसा रिसॉर्स होता है जिसके नाम में पीरियड (.) शामिल नहीं होता. उदाहरण के लिए, Campaign एक टॉप-लेवल रिसॉर्स है, लेकिन Campaign.NetworkSettings नहीं है.

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

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

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

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

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

ऑपरेशंस

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

create

संसाधन का नया इंस्टेंस बनाता है.

update

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

remove

रिसॉर्स हटाता है.

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

बैच कार्रवाइयां

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

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

जवाबों में बदलाव करना

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

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

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