Pobieranie odwołań do prototypowych klas podczas korzystania z interfejsu API wymaga albo znajomości interfejsu API, albo częstego sprawdzania dokładnej ścieżki w dokumentacji referencyjnej prototypu.
ProtoLookupUtil
Narzędzie do wyszukiwania proto umożliwia wyszukiwanie i tworzenie instancji usług, operacji, zbiorów i zasobów bez konieczności śledzenia numerów wersji interfejsu API i przestrzeni nazw.
Oto jak zwykle tworzysz instancję kampanii:
campaign = Google::Ads::GoogleAds::V19::Resources::Campaign.new
Za pomocą proto lookup util możesz użyć prostszej formy:
campaign = client.resource.campaign
Podczas pobierania zasobu, usługi lub operacji zwracany jest konkretny egzemplarz danego elementu. Podczas pobierania wyliczenia zwracane jest odwołanie do klasy bez jej instancjowienia.
W przypadku enumeracji możesz użyć skrótu, aby nie trzeba było szukać prototypów enumeracji.
campaign.status = :PAUSED
Zalecamy użycie metody client.service do pobierania usług, nawet jeśli nie używasz tego narzędzia do innych celów. W ramach tej metody dostępna jest dodatkowa logika, która umożliwia przekazywanie tokenu dewelopera i szczegółów uwierzytelniania. W przypadku użycia innej metody musiałbyś je przekazać ręcznie.