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ü kullanır (en son sürümde V26. v25.1 gibi küçük API sürümleri, ana sürüm modülü olan V25'i kullanır). Alternatif olarak, arama çağrısında açık bir sürüm ön eki (ör. v26) 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::V26::Resources::Campaign.new
İstemci arama yöntemleriyle kaynağı doğrudan istemciden örneklendirebilirsiniz:
campaign = client.resource.campaign
Bir kaynak, hizmet veya işlem getirilirken söz konusu öğenin 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ı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 }