İstemci kitaplığının temel kullanımı aşağıdaki gibidir:
Kurulum
Kitaplığı yüklemenin önerilen yolu Bundler'ı kullanmaktır. Gemfile dosyasına bir satır ekleyin (x.y.z yerine kullanmak istediğiniz sürüm numarasını girin):
gem 'google-ads-googleads', '~> x.y.z'
Ardından şunu ç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 gem'in yüklenen tüm bağımlılıklarının tam sürümünü kilitler. Karamsar sürüm operatörü "~> x.y.z", bundle install veya bundle update'nin yalnızca x.y.* serisindeki yeni yama sürümlerini yüklemesini sağlar. Bu nedenle, Gemfile'nizi güncelleyerek yeni küçük veya büyük 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ığı RubyGems kullanarak yükleyin:
gem install google-ads-googleadsGem'i Yayınlar sayfasından indirip yerel dosyadan yükleyin:
gem install google-ads-googleads-[version].gem
Kimlik doğrulamayı ayarlama
API çağrılarınızın kimliğini doğrulamak için google_ads_config.rb dosyanızı yapılandırın ve Kimlik doğrulama ve yetkilendirme sayfasındaki talimatları uygulayın.
Kullanım
google-ads-googleads v41.1.0 sürümünden itibaren gem, Bundler
autorequire'ı (Bundler.require) destekler. v41.1.0'dan önceki sürümlerde (veya Bundler.require kullanılmadığında) gem'i kodunuzda açıkça isteyin:
require 'google/ads/google_ads'
İstemciyi başlatın (varsayılan olarak yapılandırmayı ~/google_ads_config.rb konumundan yükler) ve CampaignService gibi belirli bir hizmeti getirin:
# Initialize the client using ~/google_ads_config.rb.
client = Google::Ads::GoogleAds::GoogleAdsClient.new
# Fetch the CampaignService client.
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ı keşfedin.
Hata işleme
Her API çağrısı başarılı olmaz. Sunucu, API çağrılarınız başarısız olursa istisnalar oluşturur. API hatalarını yakalamak ve uygun şekilde ele almak önemlidir.
Bir API hatası oluştuğunda Google::Ads::GoogleAds::Errors::GoogleAdsError örneği oluşturulur. Hatanın ne olduğunu belirlemenize 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.