استخدام أرقام تعريف مؤقتة

من الميزات القوية لـ 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 التي استخدمناها للحملة، كما نشير أيضًا إلى هذه المجموعة الإعلانية عند إنشاء إعلان مجموعة إعلانية. تشير المجموعة الإعلانية نفسها إلى اسم المورد الذي للحملة في عملية سابقة ضمن الطلب، في حين resource_name في ad_group_ad_operation ليس ضروريًا لأنّه ليس مطلوبًا بعد الآن العملية تشير إليه.