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

من ميزات 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 غير ضروري نظرًا لعدم وجود عملية إضافية تشير إلى ذلك.