Um bei Verwendung der API Verweise auf Proto-Klassen abzurufen, müssen Sie entweder grundlegende Kenntnisse über die API haben oder häufig in der Proto-Referenzdokumentation nach dem genauen Pfad suchen müssen.
ProtoLookupUtil
Mit dem proto-Lookup-Dienstprogramm können Sie Instanzen von Diensten, Vorgängen, Aufzählungen und Ressourcen suchen und erstellen, ohne API-Versionsnummern und Namespaces im Auge zu behalten.
So instanziieren Sie eine Kampagne normalerweise:
campaign = Google::Ads::GoogleAds::V16::Resources::Campaign.new
Aber mit dem Proto-Lookup-Dienstprogramm können Sie eine einfachere Form verwenden:
campaign = client.resource.campaign
Beim Abrufen einer Ressource, eines Dienstes oder eines Vorgangs wird eine Instanz dieser Entität zurückgegeben. Beim Abrufen einer Aufzählung wird ein Verweis auf die Klasse ohne Instanziierung zurückgegeben.
Für Aufzählungen können Sie eine Verknüpfung verwenden, um die Suche nach den Aufzählungsprotos zu umgehen.
campaign.status = :PAUSED
Wir empfehlen die Verwendung der Methode client.service zum Abrufen von Diensten, auch wenn Sie dieses Dienstprogramm nicht für andere Anwendungsfälle verwenden. Diese Methode enthält eine zusätzliche Logik zur Weitergabe Ihres Entwicklertokens und der Authentifizierungsdetails, die Sie manuell verarbeiten müssen, wenn Sie eine andere Methode verwenden.