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 proto 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.
Oto jak zwykle tworzy się instancję kampanii:
campaign = Google::Ads::GoogleAds::V25::Resources::Campaign.new
Dzięki narzędziu do wyszukiwania proto możesz użyć prostszej formy:
campaign = client.resource.campaign
Podczas pobierania zasobu, usługi lub operacji zwracana jest instancja tej jednostki. Podczas pobierania wyliczenia zwracane jest odwołanie do klasy bez tworzenia instancji.
W przypadku wyliczeń możesz użyć skrótu, aby nie trzeba było wyszukiwać proto 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 Twoje dane uwierzytelniające. W przypadku użycia innej metody musiałbyś to zrobić ręcznie.