अस्थायी आईडी का इस्तेमाल करना

BatchJobService की एक बेहतरीन सुविधा यह है कि अस्थायी आईडी के इस्तेमाल का समर्थन करता है.

नए संसाधन के resource_name को तय करके ऐसा किया जा सकता है. ऐसा करने के लिए नेगेटिव आईडी. उदाहरण के लिए, अगर आपने कोई कैंपेन बनाया और उसके संसाधन का नाम बताया customers/<YOUR_CUSTOMER_ID>/campaigns/-1 के रूप में किया है, तो आप बाद में किए जाने वाले ऑपरेशन में, विज्ञापन ग्रुप को उस रिसॉर्स के नाम से रेफ़रंस किया जा सकता है और आपके बताए गए -1 को, बनाए गए कैंपेन के असल आईडी से बदल दिया जाएगा स्वचालित रूप से.

कुछ समय के लिए उपलब्ध रिसॉर्स के नाम इस्तेमाल करते समय, इन बातों का ध्यान रखें:

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

उदाहरण

ऊपर बताई गई स्थिति का एक ठोस उदाहरण देने के लिए, मान लें कि एक ही एपीआई अनुरोध में कैंपेन, विज्ञापन ग्रुप, और विज्ञापन जोड़ना हो. आपने लोगों तक पहुंचाया मुफ़्त में आपके अनुरोध पर इस तरह का स्ट्रक्चर बनाएगा:

mutate_operations: [
  {
    campaign_operation: {
      create: {
        resource_name: "customers/<YOUR_CUSTOMER_ID>/campaigns/-1",
        ...
      }
    }
  },
  {
    ad_group_operation: {
      create: {
        resource_name: "customers/<YOUR_CUSTOMER_ID>/adGroups/-2",
        campaign: "customers/<YOUR_CUSTOMER_ID>/campaigns/-1"
        ...
      }
    }
  },
  {
    ad_group_ad_operation: {
      create: {
        ad_group: "customers/<YOUR_CUSTOMER_ID>/adGroups/-2"
        ...
      }
    }
  },
]

ध्यान दें कि विज्ञापन ग्रुप के लिए एक नए अस्थायी आईडी का इस्तेमाल किया गया है, क्योंकि हम फिर से इस्तेमाल नहीं कर सकते वह -1 जिसका इस्तेमाल हमने कैंपेन के लिए किया था और हम इस विज्ञापन ग्रुप का रेफ़रंस भी देते हैं, विज्ञापन समूह का विज्ञापन बना रहे हैं. विज्ञापन समूह में ही हमारे संसाधन का नाम बताया गया है कैंपेन को पहले की कार्रवाई के दौरान तय किया गया था. हालांकि, अब ad_group_ad_operation में resource_name की ज़रूरत नहीं है, क्योंकि अब इसे ऑपरेशन इसे रेफ़र कर रहा है.