API'yi kullanırken proto sınıflarına referans getirmek için API'yi iyi anlamanız veya tam ad alanı yolu için proto referans dokümanlarına sık sık bakmanız gerekir.
ProtoLookupUtil
GoogleAdsClient (Fabrikalar ve ServiceLookup tarafından desteklenir, eski ProtoLookupUtil sınıfının yerini alır) üzerindeki arama yardımcı programı yöntemleri, API sürüm numaralarını ve modül ad alanlarını takip etmenize gerek kalmadan hizmetlerin, işlemlerin, numaralandırmaların ve kaynakların örneklerini aramanıza ve oluşturmanıza olanak tanır. Bu yöntemler, varsayılan olarak yüklü gem'iniz tarafından desteklenen en yüksek API sürümünü (en son sürümde V25; burada v25.1 gibi küçük API sürümleri, ana sürüm modüllerini V25 kullanır) kullanır. Alternatif olarak, arama çağrısında açık bir sürüm öneki (ör. v25) belirtebilirsiniz.
Arama yardımcı programı olmadan, kampanya kaynağını doğrudan sürüm oluşturulmuş ad alanından başlatırsınız:
campaign =
Google::Ads::GoogleAds::V25::Resources::Campaign.new
İstemci arama yöntemleriyle kaynağı doğrudan istemciden başlatabilirsiniz:
campaign = client.resource.campaign
Bir kaynak, hizmet veya işlem getirilirken söz konusu varlığın bir örneği döndürülür:
# Instantiate an operation
operation = client.operation.campaign
Hizmet arama
Diğer öğeler için bu yardımcı programı kullanmasanız bile hizmet istemcilerini getirmek için client.service yöntemini kullanın. client.service, döndürülen hizmet istemcisinde kimlik doğrulama kimlik bilgilerinizi ve aktarım ayarlarınızı otomatik olarak yapılandırır:
campaign_service = client.service.campaign
Numaralandırma araması
Protobuf mesajlarındaki enum alanları için numaralandırma modülünü aramak yerine doğrudan bir Ruby sembolü atayın:
campaign.status = :PAUSED
Çalışma zamanında bir numaralandırma için geçerli tüm sembolleri incelemek veya bunlar üzerinde yineleme yapmak için client.enum kullanın. Bu işlev, söz konusu numaralandırma için Google::Protobuf::EnumDescriptor değerini döndürür:
status_enum = client.enum.campaign_status
status_enum.each { |status| p status }