فراخوانی کردن «میانای برنامه‌سازی کاربردی Google Ads» با راهبرد جهش

راهبرد جهش به استفاده از AdsApp.mutate برای برقراری تماس‌های میانای برنامه‌سازی کاربردی به‌طور مستقیم اشاره دارد، به‌جای تکیه بر اشیاء خاص جاوااسکریپت Google Ads. این کار این مزیت را دارد که به شما امکان می‌دهد سریع‌تر به همه ویژگی‌های API دسترسی پیدا کنید و اگر قبلاً با نحو API آشنا باشید، مانع کمتری برای ورود دارد.

ایجاد پویش «عملکرد بیشینه» با mutate

این راهنما فرض می‌کند که کل پویش را در یک درخواست اتمی واحد ایجاد می‌کنید، نه اینکه هر موجودیت را در درخواست‌های جداگانه ایجاد کنید. این یعنی باید شناسه‌های موقت راه‌اندازی و استفاده کنید تا منابع را به یکدیگر پیوند دهید.

با انجام این کار، آرایه‌ای برای نگهداری همه عملیات‌ها ایجاد کنید:

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