Pobieranie odwołań do klas proto podczas korzystania z interfejsu API wymaga znajomości interfejsu API lub częstego przeglądania dokumentacji referencyjnej protokołu w celu uzyskania dokładnej ścieżki.
ProtoLookupUtil
Narzędzie do wyszukiwania proto pozwala wyszukiwać i tworzyć instancje usług, operacji, wyliczeń i zasobów bez konieczności śledzenia numerów wersji interfejsu API i przestrzeni nazw.
Zazwyczaj tworzenie kampanii przebiega w ten sposób:
campaign = Google::Ads::GoogleAds::V16::Resources::Campaign.new
Jednak za pomocą narzędzia wyszukiwania proto możesz użyć prostszego formularza:
campaign = client.resource.campaign
Podczas pobierania zasobu, usługi lub operacji zwracana jest instancja tej encji. Podczas pobierania wyliczenia zwracane jest odwołanie do klasy bez utworzenia instancji.
W przypadku wyliczeń możesz użyć skrótu, aby pominąć potrzebę wyszukiwania proto wyliczeń.
campaign.status = :PAUSED
Zalecamy pobieranie usług przy użyciu metody client.service
, nawet jeśli nie korzystasz z tego narzędzia do innych celów. W tej metodzie jest wbudowana dodatkowa logika, która przekazuje token programisty i szczegóły uwierzytelniania. Jeśli używasz innej metody, musisz to zrobić ręcznie.