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

من الميزات القوية في 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 ضروريًا لأنّه لا تشير إليه أي عملية أخرى.