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 untuk masuk 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 mutate

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.

Setelah ini diterapkan, buat array untuk menyimpan semua operasi:

const operations = [];

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

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

Setiap kali Anda ingin membuat operasi 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 Google Ads API. Pelajari komponen wajib dan opsional kampanye Peningkat Permintaan, dan buat operasi sesuai kebutuhan Anda.

Setelah Anda membuat semua operasi, jalankan dalam satu batch:

AdsApp.mutateAll(operations);