API'yi kullanırken proto sınıflarına referansları 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 üzerindeki arama yardımcı programı yöntemleri (Factories ve ServiceLookup tarafından desteklenir, eski ProtoLookupUtil sınıfının yerini alır), API sürüm numaralarını ve modül ad alanlarını takip etmek zorunda 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ü kullanır (en son sürümde V26; v26.1 gibi küçük API sürümleri, ana sürüm modülü V26'yı kullanır) veya arama çağrısında açık bir sürüm ön eki (ör. v26) belirtebilirsiniz.
Arama yardımcı programı olmadan, bir kampanya kaynağını doğrudan sürümlü ad alanından örneklendirirsiniz:
campaign =
Google::Ads::GoogleAds::V26::Resources::Campaign.new
İstemci arama yöntemleriyle kaynağı doğrudan istemciden örneklendirebilirsiniz:
campaign = client.resource.campaign
Bir kaynak, hizmet veya işlem getirilirken ilgili varlığın bir örneği döndürülür:
# Instantiate an operation
operation = client.operation.campaign
Hizmet arama
Bu yardımcı programı diğer öğeler için 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 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ırmanın tüm geçerli simgelerini incelemek veya bunlar üzerinde yineleme yapmak için client.enum kullanın. Bu, ilgili enum için Google::Protobuf::EnumDescriptor değerini döndürür:
status_enum = client.enum.campaign_status
status_enum.each { |status| p status }