बैच प्रोसेसिंग की मदद से, एक साथ कई सेवाओं पर एक से ज़्यादा कार्रवाइयां की जा सकती हैं. इन कार्रवाइयों के पूरा होने का इंतज़ार किए बिना, ये कार्रवाइयां एक-दूसरे पर निर्भर हो सकती हैं. परफ़ॉर्मेंस मैक्स कैंपेन बनाने और मैनेज करने के लिए, एक साथ कई प्रोसेस करने की सुविधा का इस्तेमाल किया जा सकता है.
इस गाइड में, एक साथ कई फ़ाइलों को प्रोसेस करने की सुविधा का इस्तेमाल करते समय, परफ़ॉर्मेंस मैक्स कैंपेन के बारे में खास जानकारी दी गई है. एक साथ कई अनुरोधों को प्रोसेस करने के बारे में सामान्य जानकारी देने वाली गाइड में, एक साथ कई अनुरोधों को प्रोसेस करने के बारे में सामान्य जानकारी दी गई है. साथ ही, अनुरोधों को स्ट्रक्चर करने के बारे में गाइड में, परफ़ॉर्मेंस मैक्स कैंपेन बनाने या मैनेज करने के लिए अनुरोध बनाने के बारे में पूरी जानकारी दी गई है.
एक साथ कई फ़ाइलों को प्रोसेस करने की सुविधा का इस्तेमाल करके, परफ़ॉर्मेंस मैक्स कैंपेन बनाने के लिए यह तरीका अपनाएं:
नई बैच जॉब बनाना
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
को कॉल करें. इसके लिए, बैच प्रोसेस करने से जुड़ी सामान्य गाइड में, बैच जॉब के सभी नतीजों की सूची वाले चरण का पालन करें.