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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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