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

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

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

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

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

  • 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 सेट हो.

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

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

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

बदलाव से जुड़े जवाब

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

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

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

बदलावों को ट्रैक करना

अपने Google Ads खाते में मौजूद ऑब्जेक्ट में किए गए बदलावों को ट्रैक करने या ऑब्जेक्ट की मौजूदा स्थिति को वापस पाने के लिए, change_status और change_event संसाधनों का इस्तेमाल किया जा सकता है.

  • change_status से यह पता चलता है कि किसी तय समयावधि में किन संसाधनों में बदलाव हुआ है.
  • change_event में बदलावों का पूरा इतिहास दिखता है. इसमें बदले गए फ़ील्ड की पुरानी और नई वैल्यू भी शामिल होती हैं.

इन संसाधनों से क्वेरी करने के लिए, GoogleAdsService.SearchStream या GoogleAdsService.Search तरीके का इस्तेमाल करें. GoogleAdsService का इस्तेमाल करके रिपोर्ट स्ट्रीम करने के बारे में ज़्यादा जानें.

पीछे जाएं
वर्शन
आगे बढ़ें
ऑब्जेक्ट वापस लाए जा रहे हैं