Pobieranie odwołań do klas proto podczas korzystania z interfejsu API wymaga dogłębnej znajomości interfejsu API lub częstego sprawdzania dokumentacji referencyjnej proto pod kątem dokładnej ścieżki przestrzeni nazw.
ProtoLookupUtil
Metody narzędziowe wyszukiwania w GoogleAdsClient (obsługiwane przez Factories i ServiceLookup, zastępujące starszą klasę ProtoLookupUtil) umożliwiają wyszukiwanie i tworzenie instancji usług, operacji, wyliczeń i zasobów bez konieczności śledzenia numerów wersji interfejsu API i przestrzeni nazw modułów. Domyślnie te metody używają najwyższej wersji interfejsu API obsługiwanej przez zainstalowany gem (V26 w najnowszej wersji, gdzie mniejsze wersje interfejsu API, takie jak v25.1, używają modułu wersji głównej V25). Możesz też określić jawny prefiks wersji (np. v26) w wywołaniu wyszukiwania.
Bez narzędzia do wyszukiwania instancję zasobu kampanii tworzy się bezpośrednio z przestrzeni nazw z numerem wersji:
campaign =
Google::Ads::GoogleAds::V26::Resources::Campaign.new
Dzięki metodom wyszukiwania klienta możesz utworzyć instancję zasobu bezpośrednio z klienta:
campaign = client.resource.campaign
Podczas pobierania zasobu, usługi lub operacji zwracane jest wystąpienie tego elementu:
# Instantiate an operation
operation = client.operation.campaign
Wyszukiwanie usługi
Używaj metody client.service do pobierania klientów usługi, nawet jeśli nie używasz tego narzędzia w przypadku innych encji. client.service automatycznie konfiguruje dane uwierzytelniające i ustawienia transportu w zwracanym kliencie usługi:
campaign_service = client.service.campaign
Wyszukiwanie wyliczenia
W przypadku pól typu wyliczeniowego w komunikatach protobuf przypisz bezpośrednio symbol Ruby zamiast wyszukiwać moduł wyliczeniowy:
campaign.status = :PAUSED
Aby sprawdzić lub iterować po wszystkich prawidłowych symbolach wyliczenia w czasie działania, użyj client.enum, która zwraca Google::Protobuf::EnumDescriptor dla tego typu wyliczeniowego:
status_enum = client.enum.campaign_status
status_enum.each { |status| p status }