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

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

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

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

يمكنك قراءة المزيد من المعلومات والاطّلاع على مثال على عملية في مستندات تغيير REST في Google Ads API.

بمجرد إنشاء جميع عملياتنا، قم بتنفيذها في دفعة واحدة:

AdsApp.mutateAll(operations);