परफ़ॉर्मेंस मैक्स कैंपेन के लिए बैच प्रोसेसिंग

बैच प्रोसेसिंग की मदद से, एक साथ कई सेवाओं पर एक से ज़्यादा कार्रवाइयां की जा सकती हैं. इन कार्रवाइयों के पूरा होने का इंतज़ार किए बिना, ये कार्रवाइयां एक-दूसरे पर निर्भर हो सकती हैं. परफ़ॉर्मेंस मैक्स कैंपेन बनाने और मैनेज करने के लिए, एक साथ कई प्रोसेस करने की सुविधा का इस्तेमाल किया जा सकता है.

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

एक साथ कई फ़ाइलों को प्रोसेस करने की सुविधा का इस्तेमाल करके, परफ़ॉर्मेंस मैक्स कैंपेन बनाने के लिए यह तरीका अपनाएं:

नई बैच जॉब बनाना

BatchJob संसाधन बनाने के लिए, एक साथ कई फ़ाइलों को प्रोसेस करने की सामान्य प्रोसेस के जॉब बनाने के चरण का पालन करें.

डेटा में बदलाव करने से जुड़ी कार्रवाइयों की सूची बनाना

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

CampaignOperation और CampaignAssetOperation की ज़रूरी शर्तें

जब किसी कैंपेन के लिए ब्रैंड से जुड़े दिशा-निर्देश चालू होते हैं (ब्रैंड से जुड़े दिशा-निर्देश देखें), तो आपको CampaignAsset संसाधनों का इस्तेमाल करके, ब्रैंड ऐसेट को कैंपेन से लिंक करना होगा. इसके अलावा, बैच जॉब में Campaign संसाधन बनने के तुरंत बाद, इन CampaignAsset संसाधनों को बनाना ज़रूरी है. अगर ब्रैंड दिशा-निर्देश चालू होने पर, Campaign संसाधन के तुरंत बाद CampaignAsset संसाधन नहीं बनाए जाते हैं, तो अनुरोध पूरा नहीं होगा. साथ ही, CampaignError कोड दिखेगा, जिससे पता चलेगा कि ऐसेट मौजूद नहीं हैं. समस्या हल करने का तरीका देखें. ऑपरेशन की उसी सूची में बाद में CampaignAsset बनाने के ऑपरेशन शामिल करने से, यह गड़बड़ी नहीं रुकेगी.

AssetGroupOperation और AssetGroupAssetOperation की ज़रूरी शर्तें

MutateOperation टाइप के ऐसे ऑपरेशन जो किसी बैच जॉब में AssetGroup और AssetGroupAsset संसाधन बनाते हैं, उनके बीच कोई अन्य ऑपरेशन नहीं होना चाहिए. ऐसा इसलिए, क्योंकि प्रोसेस होने पर इन ऑपरेशन को एक साथ ग्रुप किया जाता है. ऐसा न करने पर, अनुरोध में AssetGroupError दिखता है, जिससे पता चलता है कि कुछ एसेट मौजूद नहीं हैं. भले ही, एसेट से जुड़ी ज़रूरी शर्तों को पूरा करने के लिए ज़रूरी ऑपरेशन, ऑपरेशन की सूची में बाद में शामिल किए गए हों.

AssetGroupListingGroupFilterOperation सबसे सही तरीके

AssetGroupListingGroupFilter के संदर्भ में, लिस्टिंग ग्रुप फ़िल्टर का इस्तेमाल करते समय, हमारा सुझाव है कि आप एक ही AssetGroup को टारगेट करने वाले AssetGroupListingGroupFilterOperation ऑपरेशन को, बैच जॉब में लगातार जोड़ें. इससे बैच को बांटने के दौरान, ऑपरेशन के सेट को एक साथ माना जाता है. एक साथ कई फ़ाइलों को बांटने और स्टोर पेज के ग्रुप पर असर डालने वाले अन्य फ़ैक्टर के बारे में ज़्यादा जानने के लिए, स्टोर पेज के ग्रुप को एक साथ कई फ़ाइलों में प्रोसेस करने के बारे में गाइड देखें.

जॉब में बदलाव करने की कार्रवाइयां जोड़ना

दूसरे चरण में मौजूद, डेटा में बदलाव करने वाले ऑपरेशन को सूची में जोड़ें. इसके बाद, पहले चरण में बनाए गए बैच जॉब में, डेटा में बदलाव करने की सूची जोड़ने के लिए, AddBatchJobOperations को कॉल करें. डेटा में बदलाव करने वाले ऑपरेशन की सूची जोड़ने के लिए, एक साथ कई डेटा फ़ाइलों को प्रोसेस करने की सामान्य गाइड में, ऑपरेशन जोड़ने का चरण का पालन करें.

बैच जॉब चलाना

अपलोड की गई जॉब को चलाने के लिए, RunBatchJob को कॉल करें. उदाहरण के लिए, एक साथ कई फ़ाइलों को प्रोसेस करने से जुड़ी सामान्य गाइड में, एक साथ कई फ़ाइलों को प्रोसेस करने की प्रोसेस शुरू करना चरण देखें.

जॉब की स्थिति देखना

बैच जॉब, लंबे समय तक चलने वाले ऑपरेशन के तौर पर शुरू होते हैं और आम तौर पर उन्हें पूरा होने में समय लगता है. जॉब शुरू करने के बाद, लंबे समय तक चलने वाले ऑपरेशन के GetOperation तरीकों का इस्तेमाल करके, जॉब की स्थिति को पोल करें. ऐसा तब तक करें, जब तक जॉब पूरा नहीं हो जाता.

जब सभी बैच जॉब पूरे हो जाएं, तो उनके स्टेटस और जवाबों को प्रिंट करने के लिए, ListBatchJobResults को कॉल करें. इसके लिए, बैच प्रोसेस करने से जुड़ी सामान्य गाइड में, बैच जॉब के सभी नतीजों की सूची वाले चरण का पालन करें.