API lanjutan di skrip Google Ads memungkinkan developer terhubung ke Google API publik tertentu dengan penyiapan yang lebih sedikit dibandingkan menggunakan antarmuka HTTP-nya. Anda dapat menggunakan API ini seperti layanan bawaan skrip, dan API ini menawarkan kemudahan yang sama seperti pelengkapan otomatis dan otorisasi otomatis.
Lihat halaman cuplikan kode kami untuk mengetahui beberapa contoh yang menunjukkan cara menggunakan API ini.
API lanjutan yang tersedia
- Google Analytics
- Catatan: API lanjutan
Analyticsdalam dialog Advanced APIs menargetkan API Universal Analytics v3 yang telah dihentikan, dan permintaan ke API tersebut akan gagal. Skrip Google Ads tidak mendukung layanan lanjutanAnalyticsDataatauAnalyticsAdminGoogle Analytics 4. Untuk mengkueri data Google Analytics 4 dari skrip, kirim permintaan HTTPS ke Google Analytics Data API menggunakan layananUrlFetchAppdan OAuth 2.0. Anda juga dapat menautkan properti Google Analytics 4 ke akun Google Ads untuk membagikan data konversi situs dan aplikasi secara langsung. Untuk petunjuk penyiapan, lihat panduan penyiapan Analytics. - Google BigQuery
- Anda dapat memuat data dalam jumlah besar ke Google Cloud Storage, lalu membuat kueri data tersebut menggunakan Google BigQuery. Misalnya, Anda dapat memuat data cuaca publik selama 10 tahun terakhir, lalu membuat kueri untuk suhu rata-rata suatu wilayah dalam skrip yang menggunakan informasi tersebut untuk menyesuaikan bid. Kegunaan lainnya adalah untuk melakukan penghitungan angka pada data performa akun Anda selama beberapa tahun.
- Google Kalender
- Skrip Anda dapat membuat acara untuk tugas mendatang (misalnya, menjalankan laporan performa untuk kampanye Anda 2 minggu dari hari ini), atau melakukan tindakan berdasarkan entri yang Anda buat di kalender (misalnya, mengaktifkan kampanye pada tanggal tertentu).
- Google Slide
- Skrip Anda dapat mengekspor detail atau statistik kampanye ke Google Slide untuk memublikasikan informasi tersebut dalam format yang dapat dipresentasikan.
- Google Tasks
- Skrip Anda dapat membuat daftar pengingat untuk tugas mendatang (misalnya, menjalankan laporan performa untuk kampanye Anda dua minggu dari hari ini), atau melakukan tindakan berdasarkan entri yang Anda buat di daftar pengingat (misalnya, mengaktifkan kampanye pada tanggal tertentu).
- Merchant API
- Skrip Anda dapat menggunakan Merchant API untuk mengupload dan mengelola listingan produk serta mengelola akun Google Merchant Center Anda. Dalam skrip, hal ini dapat berguna untuk memeriksa listingan produk dan menautkan produk tertentu ke iklan tertentu. Merchant API memiliki sub-API yang dapat diaktifkan satu per satu dalam dialog Advanced APIs. Anda dapat mempelajari lebih lanjut cara menautkan akun Google Merchant Center melalui panduan Mendaftar sebagai developer.
- Konten Belanja
- Skrip Anda dapat menggunakan Google Content API for Shopping untuk mengupload dan mengelola listingan produk serta mengelola akun Google Merchant Center Anda. Dalam skrip, hal ini dapat berguna untuk memeriksa listingan produk dan menautkan produk tertentu ke iklan tertentu. Catatan: Content API for Shopping akan dihentikan pada 18 Agustus 2026. Sebagai gantinya, gunakan Merchant API, yang dijelaskan di bagian sebelumnya.
- YouTube dan YouTube Analytics
- Anda dapat mengambil dan memperbarui video, playlist, dll., serta data performa video untuk membuat keputusan bidding.
Mengaktifkan API lanjutan
Untuk melihat Google API yang tersedia sebagai API lanjutan, klik Advanced APIs di panel editor atas untuk menampilkan dialog Advanced APIs. Pilih API yang ingin Anda aktifkan.
Klik Simpan untuk menyimpan pilihan Anda dan kembali ke editor skrip. API baru akan diaktifkan untuk skrip Anda dan tersedia dalam daftar pelengkapan otomatis.
Pertimbangan tambahan
Ada beberapa hal yang perlu diperhatikan saat menggunakan API lanjutan.
Dependensi
Hanya pengguna yang membuat skrip di akun yang dapat mengubah dependensi API lanjutan untuk skrip tersebut.
Izin
Saat mengakses API lanjutan, skrip menggunakan izin pengguna yang
memberikan otorisasi pada skrip. Pengguna yang memberikan otorisasi harus memiliki akses yang diperlukan ke semua
data yang diperlukan skrip. Misalnya, untuk menggunakan API lanjutan BigQuery,
pengguna yang memberikan otorisasi harus memiliki izin yang diperlukan untuk project Google
Cloud dan set data BigQuery target.
Pertimbangan untuk skrip sebelum Mei 2019
Untuk skrip yang dibuat sebelum Mei 2019, Anda mungkin perlu mengaktifkan API yang relevan secara manual di Project Google Cloud yang terkait dengan skrip tersebut. Anda akan mengetahui apakah skrip Anda terpengaruh jika melihat link ke Konsol Google Cloud di dialog API lanjutan.
Mengaktifkan API lanjutan
Untuk skrip sebelum tahun 2019, Anda harus mengaktifkan secara manual setiap API lanjutan yang ingin digunakan dalam skrip:
- Klik tombol Advanced APIs. Di jendela dialog berikut, klik link ke Konsol Google Cloud.
- Jika project Anda belum dipilih, pilih project dari menu drop-down Project.
- Telusuri API yang ingin Anda gunakan dalam skrip dengan memasukkan nama API di kotak penelusuran.
- Pilih API dari hasil penelusuran, lalu klik tombol "Enable" di halaman berikutnya.
Jika pengguna yang membuat skrip kemudian dihapus dari akun, setiap pengguna baru yang mencoba mengakses skrip akan diminta untuk mengaktifkan kembali dependensi API lanjutan, serta memberikan otorisasi ulang pada skrip.