تشير استراتيجية التغيير إلى استخدام
AdsApp.mutate لطلب بيانات من واجهة برمجة التطبيقات
مباشرةً، بدلاً من الاعتماد على عناصر محدّدة في نصوص "إعلانات Google" البرمجية. ويتيح لك ذلك الوصول إلى جميع ميزات واجهة برمجة التطبيقات بسرعة أكبر، كما يسهّل عليك استخدامها إذا كنت على دراية بصيغة واجهة برمجة التطبيقات.
إنشاء "حملة أداء أفضل" باستخدام mutate
يفترض هذا الدليل أنّك تنشئ الحملة بأكملها في طلب واحد، بدلاً من إنشاء كل كيان على حدة في طلبات منفصلة. هذا يعني أنّه عليك إعداد معرّفات مؤقتة واستخدامها لربط الموارد ببعضها.
بعد ذلك، أنشئ مصفوفة لتضمين جميع العمليات:
const operations = [];
ستحتاج بشكل متكرّر إلى الرقم التعريفي للعميل الذي تُنشئ الحملة له، لأنّه مطلوب في كل اسم مورد.
const customerId = AdsApp.currentAccount().getCustomerId();
في كل مرة تريد فيها إنشاء مورد جديد، ستستخدم المعرّف المؤقت التالي في اسم المورد، حتى تتمكن من الإشارة إلى هذا الكائن لاحقًا، وإدراج الكائن الذي تم إنشاؤه في المصفوفة:
const newOperation = {
[OPERATION_TYPE_VARIES]: {
create: {
resourceName: `customers/${customerId}/[EXACT_PATH_VARIES]/${getNextTempId()}`
// Other fields, relevant to the resource being created.
}
}
}
operations.push(newOperation);
يمكنك الاطّلاع على مزيد من المعلومات ومثال على عملية في مستندات Google Ads API REST mutate. تعرَّف على المكوّنات المطلوبة والاختيارية في "حملة الأداء الأفضل"، وأنشئ عمليات تناسب احتياجاتك.
بعد إنشاء جميع العمليات، نفِّذها في دفعة واحدة:
AdsApp.mutateAll(operations);