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

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

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

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

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

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