تبديل الاستراتيجية

سيتم تقديم هذا الدليل لإنشاء نموذج مشابه تمامًا لدلائل "حملات الأداء الأفضل" الحالية، والتي تفترض أنّك ستنشئ الحملة بالكامل في طلب واحد، بدلاً من إنشاء كلّ عنصر على حدة في طلبات منفصلة. وهذا يعني أنّك ستحتاج إلى استخدام أرقام تعريف مؤقتة لربط الموارد ببعضها، لأنّك لن تعرف أسماء الموارد الكاملة إلى أن تتلقّى ردّ واجهة برمجة التطبيقات.

لإجراء ذلك، عليك كتابة بعض الرموز البرمجية لضمان عدم إنشاء أي معرفات مؤقتة مكرّرة:

let nextId = -1;

function getNextTempId() {
    const ret = nextId;
    nextId -= 1;
    return ret;
}

ستؤدي كلّ مكالمة متتالية إلى getNextTempId إلى عرض رقم أقل بواحد من الرقم السابق. بما أنّ جميع المعرّفات المؤقتة يجب أن تكون سالبة، ابدأ من -1.

بعد تنفيذ ذلك، يمكنك الآن إنشاء صفيف لتضمين جميع العمليات:

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);