إجراء طلبات Google Ads API باستخدام استراتيجية التعديل

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

إنشاء "حملة أداء أفضل" باستخدام طريقة التعديل

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

بعد ذلك، أنشئ مصفوفة لتضم جميع العمليات:

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. تعلَّف على المكوّنات المطلوبة والاختيارية في "حملة أداء أفضل"، وأنشئ عمليات لتلبية احتياجاتك.

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

AdsApp.mutateAll(operations);