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.

Membuat kampanye Performa Maksimal 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 ingin membuat resource baru, Anda akan menggunakan 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 Performa Maksimal, dan buat operasi untuk kebutuhan Anda.

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

AdsApp.mutateAll(operations);