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

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

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

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