تبديل

تشير استراتيجية التعديل إلى استخدام AdsApp.mutate لإجراء طلبات بيانات من واجهة برمجة التطبيقات مباشرةً، بدلاً من الاعتماد على عناصر معيّنة في نصوص "إعلانات Google" البرمجية. تتيح لك هذه الاستراتيجية الوصول إلى جميع ميزات واجهة برمجة التطبيقات بسرعة أكبر، كما أنّها لا تتطلّب خبرة كبيرة إذا كنت على دراية ببنية واجهة برمجة التطبيقات. هذه هي الطريقة الوحيدة لتعديل حملات البحث باستخدام نصوص إعلانات 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);