فراخوانی‌های API گوگل ادز را با استراتژی mutate انجام دهید

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

با mutate یک کمپین Performance Max ایجاد کنید

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

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

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

می‌توانید اطلاعات بیشتر و نمونه‌ای از عملیات را در مستندات جهش REST API گوگل ادز مشاهده کنید. در مورد اجزای مورد نیاز و اختیاری یک کمپین Performance Max اطلاعات کسب کنید و عملیات‌هایی را برای نیازهای خود ایجاد کنید.

پس از اینکه تمام عملیات خود را ساختید، آنها را در یک دسته اجرا کنید:

AdsApp.mutateAll(operations);