API lanjutan dalam skrip Google Ads memungkinkan developer berpengalaman terhubung ke Google API publik tertentu dengan penyiapan yang lebih sedikit dibandingkan menggunakan antarmuka HTTP mereka. Anda menggunakan API ini seperti layanan bawaan skrip, dan API tersebut menawarkan kemudahan yang sama seperti pelengkapan otomatis dan otorisasi otomatis.
Kemungkinan penggunaan API Lanjutan
- Google Analytics
- Anda dapat menggunakan Google Analytics untuk melacak traffic yang datang ke situs Anda dan menyesuaikan bid kampanye. Jika menautkan properti Google Analytics ke akun Google Ads, Anda juga dapat menganalisis aktivitas pelanggan di situs Anda. Informasi ini dapat menjelaskan jumlah traffic situs atau penjualan yang berasal dari Google Ads serta membantu meningkatkan kualitas iklan dan situs Anda. Anda dapat mempelajari lebih lanjut cara menautkan akun Analytics dan Google Ads di pusat bantuan kami.
- 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 dalam menyesuaikan bid. Penggunaan lainnya adalah mengolah data performa akun Anda selama beberapa tahun.
- YouTube dan YouTube Analytics
- Anda dapat mengambil dan memperbarui video, playlist, dll. serta data performa video untuk membuat keputusan bidding.
- Google Kalender
- Skrip Anda dapat membuat peristiwa untuk tugas mendatang (misalnya, menjalankan laporan performa kampanye 2 minggu dari sekarang), atau menjalankan tindakan berdasarkan entri yang Anda buat di kalender (misalnya, mengaktifkan kampanye pada tanggal tertentu).
- Konten Belanja
- Skrip Anda dapat menggunakan Google Content API for Shopping di Apps Script. Dengan API ini, pengguna Google Merchant Center dapat mengupload dan mengelola listingan produk serta mengelola akun Merchant Center mereka. Dalam skrip, hal ini dapat berguna untuk memeriksa listingan produk dan menautkan produk tertentu ke iklan tertentu.
- Google Tasks
- Skrip Anda dapat membuat daftar pengingat untuk tugas mendatang (misalnya, menjalankan laporan performa kampanye dua minggu dari sekarang), atau melakukan tindakan berdasarkan entri yang Anda buat di daftar pengingat (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 rapi.
Mengaktifkan API Lanjutan
Untuk melihat Google API mana yang tersedia sebagai API lanjutan, klik tombol Advanced APIs di panel editor bagian atas.
Tindakan ini akan memunculkan dialog Advanced APIs. Periksa API yang ingin Anda aktifkan.
Selanjutnya, klik link Konsol API Google untuk menampilkan halaman Konsol API di Konsol API yang berisi project yang terkait dengan skrip Anda; atau, 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.
Di hasil penelusuran, pilih API, dan di halaman berikut, pilih Enable. Jika Anda melihat tombol Disable, berarti API ini sudah diaktifkan. Ulangi tindakan ini untuk setiap API yang ingin Anda aktifkan.
Untuk melihat daftar API yang diaktifkan untuk project, pilih halaman Dashboard. Pastikan semua Advanced API yang ingin Anda gunakan untuk skrip sudah tercantum.
Sekarang tutup dialog API Lanjutan untuk kembali ke editor Anda. API baru akan diaktifkan untuk skrip Anda dan tersedia di daftar pelengkapan otomatis.
API yang tersedia
API berikut tersedia untuk digunakan:
| Nama API | Dokumentasi |
|---|---|
| Google Analytics | https://developers.google.com/apps-script/advanced/analytics |
| Google BigQuery | https://developers.google.com/apps-script/advanced/bigquery |
| Google Kalender | https://developers.google.com/apps-script/advanced/calendar |
| Google Slide | https://developers.google.com/apps-script/advanced/slides |
| Google Tasks | https://developers.google.com/apps-script/advanced/tasks |
| Konten Belanja | https://developers.google.com/apps-script/advanced/shopping-content |
| YouTube | https://developers.google.com/apps-script/advanced/youtube |
| YouTube Analytics | https://developers.google.com/apps-script/advanced/youtube-analytics |
Anda juga dapat melihat halaman cuplikan kode kami untuk beberapa contoh cara menggunakan API ini.
Pertimbangan akhir
Ada beberapa hal yang perlu diingat saat menggunakan Advanced API.
Project ID
Setiap skrip Google Ads memiliki Project ID Google Cloud Platform (juga dikenal sebagai nomor project) yang terkait dengannya. Anda dapat menemukan nomor project skrip dengan membuka halaman Konsol API Google dari dialog Advanced APIs. Project ID ini dibuat saat Anda membuat skrip, dan dikaitkan dengan pengguna yang membuat skrip Google Ads. Jika pengguna yang membuat skrip nantinya dihapus dari akun, pengguna yang mencoba mengakses skrip akan diminta untuk memberikan otorisasi ulang pada skrip dan menyiapkan dependensi Advanced API lagi. ID Project Developer Google baru juga akan dibuat, dan Anda perlu menyiapkan API Lanjutan lagi, seperti yang dijelaskan sebelumnya dalam dokumen ini.
Dependensi
Hanya pengguna yang membuat skrip di akun yang dapat mengubah dependensi Advanced APIs untuk skrip tersebut.
Izin
Saat mengakses API, skrip menggunakan izin pengguna yang mengotorisasi skrip. Pastikan pengguna yang memberikan otorisasi pada skrip memiliki akses yang diperlukan ke semua Advanced API yang digunakan serta data yang diperlukan skrip. Jika Anda menggunakan Google Analytics API, pastikan pengguna yang memberikan otorisasi pada skrip memiliki izin yang diperlukan untuk mengakses akun Analytics.
Persyaratan dan Ketentuan
Setiap Advanced API mungkin memiliki Persyaratan dan Ketentuannya sendiri yang harus Anda setujui saat mengaktifkan API di Konsol API Google.
Kuota
Sebagian besar Advanced API memiliki kuota harian gratis yang terkait dengannya. Setelah skrip melebihi kuota ini, API akan berhenti berfungsi sampai Anda meminta data tambahan, atau kuota gratis diisi kembali. Anda dapat memantau kuota yang digunakan oleh skrip dengan membuka Konsol API Google untuk skrip dari dialog Advanced APIs. Konsol API Google juga menyediakan cara untuk meminta kuota tambahan untuk API.
Penagihan
Beberapa Advanced API mengharuskan Anda membayar penggunaan. Pembayaran ini dikelola melalui project Google Cloud Platform yang terkait dengan skrip Anda, bukan melalui Google Ads. Lihat dokumentasi kami untuk mengetahui detail selengkapnya tentang cara mengaktifkan penagihan untuk project Google Cloud Platform skrip Anda.