Pobieranie odwołań do klas proto podczas korzystania z interfejsu API wymaga, aby użytkownik dobrze znał interfejs API lub często sprawdzał dokumentację referencyjną proto, aby znaleźć dokładną ścieżkę.
ProtoLookupUtil
Narzędzie do wyszukiwania protokołów umożliwia wyszukiwanie i tworzenie instancji usług, operacji, wyliczeń i zasobów bez konieczności śledzenia numerów wersji interfejsu API i przestrzeni nazw.
Kampanię zwykle tworzy się w ten sposób:
campaign = Google::Ads::GoogleAds::V21::Resources::Campaign.new
Dzięki narzędziu do wyszukiwania proto możesz jednak użyć prostszej formy:
campaign = client.resource.campaign
Podczas pobierania zasobu, usługi lub operacji zwracana jest instancja tego elementu. Podczas pobierania wyliczenia zwracana jest referencja do klasy, bez tworzenia jej instancji.
W przypadku wyliczeń możesz użyć skrótu, aby nie musieć wyszukiwać protokołów wyliczeń.
campaign.status = :PAUSED
Zalecamy używanie metody client.service do pobierania usług, nawet jeśli nie używasz tego narzędzia w innych przypadkach. Ta metoda zawiera dodatkową logikę, która przekazuje token dewelopera i szczegóły uwierzytelniania. W przypadku użycia innej metody musiałbyś(-abyś) to robić ręcznie.