অস্থায়ী আইডি ব্যবহার করে

BatchJobService এর একটি শক্তিশালী বৈশিষ্ট্য হল এটি অস্থায়ী আইডি ব্যবহার সমর্থন করে।

আপনি নতুন রিসোর্সের resource_name নির্দিষ্ট করে একটি নেতিবাচক আইডি ব্যবহার করতে পারেন। উদাহরণস্বরূপ, ধরুন আপনি একটি প্রচারণা তৈরি করেছেন এবং এর রিসোর্সের নাম customers/<YOUR_CUSTOMER_ID>/campaigns/-1 হিসাবে উল্লেখ করেছেন। যখন আপনি পরবর্তী কোনও অপারেশনে বিজ্ঞাপন গ্রুপ তৈরি করেন, তখন আপনি সেই রিসোর্সের নাম দিয়ে এটি উল্লেখ করতে পারেন এবং আপনার নির্দিষ্ট করা -1 স্বয়ংক্রিয়ভাবে তৈরি প্রচারণার আসল আইডি দ্বারা প্রতিস্থাপিত হবে।

অস্থায়ী রিসোর্সের নাম ব্যবহার করার সময় এখানে কিছু বিষয় মনে রাখতে হবে:

• একটি অস্থায়ী রিসোর্সের নাম শুধুমাত্র একটি রিসোর্সে সংজ্ঞায়িত হওয়ার পরেই ব্যবহার করা যেতে পারে। নিম্নলিখিত উদাহরণে, বিজ্ঞাপন গ্রুপের অপারেশনটি অপারেশনের তালিকায় প্রচারাভিযানের অপারেশনের পরে উপস্থিত হতে হবে।
• অস্থায়ী রিসোর্সের নামগুলি চাকরি বা মিউটেট অনুরোধগুলিতে মনে রাখা হয় না। পূর্ববর্তী চাকরি বা মিউটেট অনুরোধে তৈরি কোনও রিসোর্স উল্লেখ করতে, এর আসল রিসোর্সের নাম ব্যবহার করুন।
• একটি একক কাজ বা মিউটেট অনুরোধের জন্য, প্রতিটি অস্থায়ী রিসোর্স নামের জন্য একটি অনন্য ঋণাত্মক সংখ্যা ব্যবহার করা আবশ্যক, এমনকি যদি সেগুলি বিভিন্ন ধরণের রিসোর্স থেকেও হয়। যদি একটি অস্থায়ী আইডি একটি একক কাজ বা মিউটেট অনুরোধে পুনরায় ব্যবহার করা হয়, তাহলে একটি ত্রুটি ফিরে আসে।

উদাহরণ

ধরুন আপনি একটি একক API অনুরোধে একটি প্রচারণা, একটি বিজ্ঞাপন গ্রুপ এবং একটি বিজ্ঞাপন যুক্ত করতে চান। আপনি আপনার অনুরোধের জন্য নিম্নলিখিতগুলির অনুরূপ একটি কাঠামো তৈরি করবেন:

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 প্রয়োজন হয় না কারণ পরবর্তী কোনও অপারেশন এটিকে উল্লেখ করছে না।