إجراء طلبات 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);