Penggunaan dasar library klien adalah sebagai berikut:
Penginstalan
Cara yang direkomendasikan untuk menginstal library adalah dengan menggunakan Bundler. Tambahkan baris
ke Gemfile Anda (ganti x.y.z dengan nomor versi yang ingin Anda gunakan):
gem 'google-ads-googleads', '~> x.y.z'
Kemudian, jalankan:
bundle install
Perintah ini menggunakan Bundler untuk mengupdate Gemfile.lock Anda, mengunci ke versi persis gem dan semua dependensi gem yang diinstal. Operator
versi pesimis "~> x.y.z" memastikan bahwa bundle install atau
bundle update hanya menginstal versi patch baru dalam seri x.y.*, sehingga Anda
harus memilih untuk menggunakan versi minor atau mayor baru secara manual dengan memperbarui Gemfile.
Opsi penginstalan lainnya
Jika tidak menggunakan Bundler, Anda dapat menggunakan salah satu opsi berikut:
Instal library ini menggunakan RubyGems:
gem install google-ads-googleadsDownload gem dari halaman Rilis dan instal dari file lokal:
gem install google-ads-googleads-[version].gem
Menyiapkan autentikasi
Untuk mengautentikasi panggilan API, konfigurasi file google_ads_config.rb Anda dan
ikuti petunjuk di halaman
Autentikasi dan otorisasi.
Penggunaan
Mulai dari google-ads-googleads v41.1.0, gem mendukung autorequire Bundler (Bundler.require). Dalam versi sebelum v41.1.0 (atau saat tidak
menggunakan Bundler.require), secara eksplisit memerlukan gem dalam kode Anda:
require 'google/ads/google_ads'
Lakukan inisialisasi klien (yang memuat konfigurasi dari ~/google_ads_config.rb
secara default) dan ambil layanan tertentu, seperti CampaignService:
# Initialize the client using ~/google_ads_config.rb.
client = Google::Ads::GoogleAds::GoogleAdsClient.new
# Fetch the CampaignService client.
campaign_service = client.service.campaign
Lihat contoh di GitHub untuk mengetahui demonstrasi yang lebih mendetail tentang cara menggunakan library.
Setelah Anda memahami contohnya, pelajari factory, yang menyediakan serangkaian metode praktis tingkat tinggi untuk menggunakan Google Ads API.
Penanganan error
Tidak semua panggilan API berhasil. Server akan memunculkan pengecualian jika panggilan API Anda gagal. Penting untuk mencatat error API dan menanganinya dengan tepat.
Instance Google::Ads::GoogleAds::Errors::GoogleAdsError dimunculkan saat terjadi error API. Objek ini berisi detail untuk membantu Anda menentukan penyebab masalah, dan Anda dapat menyiapkan fungsi pembantu untuk menangani error. Lihat contoh
penangan error di GitHub.