Melakukan panggilan Google Ads API dengan strategi mutate

Strategi mutasi mengacu pada penggunaan AdsApp.mutate untuk melakukan panggilan API secara langsung, bukan mengandalkan objek khusus skrip Google Ads. Hal ini memberikan manfaat karena Anda dapat mengakses semua fitur API dengan lebih cepat, dan memiliki hambatan yang lebih rendah jika Anda sudah memahami sintaksis API. Ini adalah satu-satunya cara untuk mengubah kampanye Peningkat Permintaan menggunakan skrip Google Ads.

Membuat kampanye Peningkat Permintaan dengan mutasi

Panduan ini mengasumsikan bahwa Anda membuat seluruh kampanye dalam satu permintaan atomik, bukan membuat setiap entitas satu per satu dalam permintaan terpisah. Artinya, Anda harus menyiapkan dan menggunakan ID sementara untuk menautkan resource satu sama lain.

Dengan demikian, buat array untuk menyimpan semua operasi:

const operations = [];

Anda akan sering memerlukan ID pelanggan untuk pelanggan yang membuat kampanye, karena ID tersebut diperlukan di setiap nama resource.

const customerId = AdsApp.currentAccount().getCustomerId();

Setiap kali Anda ingin membuat resource baru, gunakan ID sementara berikutnya dalam nama resource, sehingga Anda dapat mereferensikan objek ini nanti, dan menyisipkan objek yang dibuat ke dalam array:

const newOperation = {
    [OPERATION_TYPE_VARIES]: {
        create: {
            resourceName: `customers/${customerId}/[EXACT_PATH_VARIES]/${getNextTempId()}`
            // Other fields, relevant to the resource being created.
        }
    }
}
operations.push(newOperation);

Anda dapat membaca lebih lanjut dan melihat contoh operasi di dokumentasi mutasi REST API Google Ads. Pelajari tentang komponen wajib dan opsional dari kampanye Peningkat Permintaan, dan buat operasi untuk kebutuhan Anda.

Setelah membuat semua operasi, jalankan operasi tersebut dalam satu batch:

AdsApp.mutateAll(operations);