Penggunaan dasar library klien adalah sebagai berikut:
Penginstalan
Cara yang direkomendasikan untuk menginstal adalah dengan menggunakan bundler. Tambahkan baris ke Gemfile Anda (ganti x.y.z dengan nomor versi yang Anda inginkan):
gem 'google-ads-googleads', '~> x.y.z'
Kemudian, jalankan:
$ bundle install
Perintah ini menggunakan bundler untuk mengupdate Gemfile.lock, mengunci ke versi gem yang tepat dan semua dependensi gem yang diinstal. Operator versi
pesimis "~> x.y.z" menyebabkan bundle update hanya menginstal
versi baru dalam seri x.y.*, sehingga Anda harus memilih versi baru secara manual
dengan mengupdate Gemfile lagi.
Opsi Penginstalan lainnya
Jika tidak menggunakan bundler, Anda dapat menggunakan salah satu opsi berikut:
- Instal library ini menggunakan gem:
terminal $ [sudo] gem install google-ads-googleads - Download gem dari
halaman Rilis dan instal
dari file lokal:
terminal $ [sudo] gem install google-ads-googleads-[version].gem
Menyiapkan Authentication
Untuk mengautentikasi panggilan API, ikuti petunjuk di halaman Autentikasi dan Otorisasi.
Penggunaan
Untuk menyertakan gem dalam kode Anda:
require 'google/ads/google_ads'
Untuk mengambil layanan tertentu, misalnya CampaignService:
client = Google::Ads::GoogleAds::GoogleAdsClient.new
campaign_service = client.service.campaign
Lihat contoh di GitHub untuk mengetahui demonstrasi yang lebih mendetail tentang cara menggunakan library.
Setelah memahami contohnya, sebaiknya Anda juga memahami factory, yang menyediakan serangkaian metode praktis tingkat tinggi untuk menggunakan Google Ads API.
Penanganan error
Tidak semua panggilan API akan berhasil. Server dapat menampilkan error jika panggilan API Anda gagal karena alasan tertentu. Penting untuk menangkap error API dan menanganinya dengan tepat.
Instance GoogleAdsException ditampilkan saat terjadi error API. Instance ini memiliki detail untuk membantu Anda mengetahui penyebab masalah, dan Anda dapat menyiapkan fungsi helper untuk menangani error. Lihat contoh pengendali error di GitHub
.