Penggunaan dasar library klien adalah sebagai berikut:
Penginstalan
Cara yang direkomendasikan untuk menginstal adalah dengan menggunakan bundler. Tambahkan baris
ke Gemfile (ganti x.y.z dengan nomor versi yang Anda minati):
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" menyebabkan bundle update hanya menginstal versi baru dalam seri x.y.*, jadi Anda harus memilih untuk menggunakan versi baru secara manual dengan mengupdate Gemfile lagi.
Opsi Penginstalan lainnya
Jika Anda 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 Anda memahami contoh-contoh tersebut, sebaiknya Anda juga memahami factories, yang menyediakan serangkaian metode praktis tingkat tinggi untuk menggunakan Google Ads API.
Penanganan error
Tidak semua panggilan API akan berhasil. Server dapat memunculkan error jika panggilan API Anda gagal karena alasan tertentu. Penting untuk mencatat error API dan menanganinya dengan tepat.
Instance GoogleAdsException ditampilkan saat terjadi error API. Fungsi ini memiliki detail untuk membantu Anda mengetahui apa yang salah, dan Anda dapat menyiapkan fungsi helper untuk menangani error. Lihat contoh
penangan error di GitHub.