Wenn Sie bei der Verwendung der API Verweise auf Proto-Klassen abrufen möchten, 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-Dienstprogramm können Sie Instanzen von Diensten, Vorgängen, Enumerationen und Ressourcen abrufen und erstellen, ohne API-Versionsnummern und Namespaces im Auge behalten zu müssen.
So erstellen Sie normalerweise eine Kampagne:
campaign = Google::Ads::GoogleAds::V19::Resources::Campaign.new
Mit dem Proto-Lookup-Dienstprogramm können Sie jedoch ein einfacheres Formular 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 zurückgegeben, ohne dass sie instanziiert wird.
Bei Aufzählungen können Sie eine Verknüpfung verwenden, um die Aufzählungsprotos nicht aufrufen zu müssen.
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 verwenden. Diese Methode enthält zusätzliche Logik, um Ihr Entwicklertoken und Ihre Authentifizierungsdetails weiterzuleiten. Bei Verwendung einer anderen Methode müssten Sie dies manuell erledigen.