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

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