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

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