استراتژی جهش

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

برای انجام این کار، باید کدی بنویسید تا مطمئن شوید که هیچ شناسه موقت تکراری ایجاد نمی کنید:

let nextId = -1;

function getNextTempId() {
    const ret = nextId;
    nextId -= 1;
    return ret;
}

هر تماس متوالی به getNextTempId یک عدد کمتر از قبلی را برمی گرداند. از آنجایی که همه شناسه های دمایی باید منفی باشند، از 1- شروع کنید.

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

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