Wenn Sie die API verwenden, um Referenzen zu Proto-Klassen abzurufen, müssen Sie entweder über ein umfassendes Wissen über die API verfügen oder häufig die Proto-Referenzdokumentation nach dem genauen Pfad durchsuchen.
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 in der Regel eine Kampagne:
campaign = Google::Ads::GoogleAds::V25::Resources::Campaign.new
Mit dem Proto-Lookup-Tool können Sie jedoch eine einfachere Form verwenden:
campaign = client.resource.campaign
Wenn Sie eine Ressource, einen Dienst oder einen Vorgang abrufen, wird eine Instanz dieser Entität zurückgegeben. Wenn Sie eine Aufzählung abrufen, wird eine Referenz zur Klasse zurückgegeben, ohne dass eine Instanziierung erfolgt.
Für Aufzählungen können Sie eine Verknüpfung verwenden, um das Suchen nach den Aufzählungs-Protos zu umgehen.
campaign.status = :PAUSED
Wir empfehlen, die Methode client.service zu verwenden, um Dienste abzurufen, auch wenn Sie dieses Tool für keine anderen Anwendungsfälle verwenden. Diese Methode enthält zusätzliche Logik, um Ihre Authentifizierungsdetails weiterzugeben. Diese müssten Sie manuell verarbeiten, wenn Sie eine andere Methode verwenden.