İstemci kitaplığının temel kullanımı aşağıdaki gibidir:
Kurulum
Kitaplığı yüklemek için Bundler'ı kullanmanız önerilir. Gemfile dosyanıza bir satır ekleyin (x.y.z yerine kullanmak istediğiniz sürüm numarasını yazın):
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 ve gem'in tam sürümünü ve yüklenen tüm bağımlılıkları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 dosyanızı güncelleyerek yeni alt veya ana 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:
RubyGems'i kullanarak bu kitaplığı yükleyin:
gem install google-ads-googleadsGem'i Sürümler 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) özelliğini destekler. v41.1.0 sürümünden önceki sürümlerde (veya Bundler.require kullanılmadığında) gem'i kodunuzda açıkça belirtmeniz gerekir:
require 'google/ads/google_ads'
İstemciyi başlatın (varsayılan olarak ~/google_ads_config.rb adresinden yapılandırmayı 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ı açıklamalar için GitHub'daki örneklere bakın.
Örneklere aşina olduktan 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. API çağrılarınız başarısız olursa sunucu istisnalar oluşturur. API hatalarını yakalamak ve uygun şekilde ele almak önemlidir.
API hatası oluştuğunda bir Google::Ads::GoogleAds::Errors::GoogleAdsError örneği oluşturulur. Bu nesne, sorunun ne olduğunu belirlemenize yardımcı olacak ayrıntılar içerir. Hataları işlemek için bir yardımcı işlev oluşturabilirsiniz. GitHub'da hata işleyici örneğini inceleyin.