İstemci kitaplığının temel kullanımı şu şekildedir:
Kurulum
Yükleme için önerilen yöntem bundler kullanmaktır. Gemfile dosyasına bir satır ekleyin (x.y.z yerine ilgilendiğiniz sürüm numarasını girin):
gem 'google-ads-googleads', '~> x.y.z'
Ardından şu komutu çalıştırın:
$ bundle install
Bu komut, Gemfile.lock dosyanızı güncellemek için bundler'ı kullanır. Bu işlem, gem'in ve yüklenen tüm gem bağımlılıklarının tam sürümünü kilitler. İyimser olmayan sürüm operatörü "~> x.y.z", bundle update'nin yalnızca x.y.* serisindeki yeni sürümleri yüklemesine neden olur. Bu nedenle, Gemfile'nizi tekrar güncelleyerek yeni sürümleri manuel olarak etkinleştirmeniz gerekir.
Diğer yükleme seçenekleri
Bundler kullanmıyorsanız aşağıdaki seçeneklerden birini kullanabilirsiniz:
- Bu kitaplığı gem kullanarak yükleyin:
terminal $ [sudo] gem install google-ads-googleads - Gem'i Releases sayfasından indirip yerel dosyadan yükleyin:
terminal $ [sudo] gem install google-ads-googleads-[version].gem
Kimlik doğrulama ayarlama
API çağrılarınızın kimliğini doğrulamak için Kimlik Doğrulama ve Yetkilendirme sayfasındaki talimatları uygulayın.
Kullanım
Gem'i kodunuza eklemek için:
require 'google/ads/google_ads'
Belirli bir hizmeti (ör. CampaignService) getirmek için:
client = Google::Ads::GoogleAds::GoogleAdsClient.new
campaign_service = client.service.campaign
Kitaplığın nasıl kullanılacağına dair daha ayrıntılı gösterimler için GitHub'daki örneklere bakın.
Örnekleri inceledikten sonra, Google Ads API ile çalışmak için bir dizi üst düzey kolaylık yöntemi sağlayan fabrikalar hakkında da bilgi edinmenizi öneririz.
Hata işleme
Her API çağrısı başarılı olmaz. API çağrılarınız herhangi bir nedenle başarısız olursa sunucu hata verebilir. API hatalarını yakalamak ve uygun şekilde ele almak önemlidir.
Bir API hatası oluştuğunda GoogleAdsException örneği oluşturulur. Neyin yanlış gittiğini anlamanıza yardımcı olacak ayrıntılar içerir ve hataları işlemek için bir yardımcı işlev ayarlayabilirsiniz. GitHub'da hata işleyici örneğini inceleyin.