Wenn Sie mit der API auf Proto-Klassen verweisen, müssen Sie entweder die API gut kennen oder häufig in der Proto-Referenzdokumentation nach dem genauen Pfad suchen.
ProtoLookupUtil
Mit dem Proto-Lookup-Tool können Sie Instanzen von Diensten, Vorgängen, Aufzählungen und Ressourcen suchen und erstellen, ohne API-Versionsnummern und Namespaces im Blick behalten zu müssen.
So instanziieren Sie eine Kampagne:
campaign = Google::Ads::GoogleAds::V20::Resources::Campaign.new
Mit dem Proto-Lookup-Tool können Sie jedoch 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 Enumeration wird ein Verweis auf die Klasse zurückgegeben, ohne dass eine Instanziierung erfolgt.
Für Aufzählungen können Sie eine Abkürzung verwenden, um das Nachschlagen der Aufzählungs-Protos zu umgehen.
campaign.status = :PAUSED
Wir empfehlen, die client.service-Methode zum Abrufen von Diensten zu verwenden, auch wenn Sie dieses Dienstprogramm für keine anderen Anwendungsfälle nutzen. In diese Methode ist zusätzliche Logik integriert, um Ihr Entwicklertoken und Ihre Authentifizierungsdetails weiterzugeben. Wenn Sie eine andere Methode verwenden, müssten Sie dies manuell erledigen.