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

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

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

AdsApp.mutateAll(operations);