Wenn Sie die API verwenden, müssen Sie entweder ein umfassendes Verständnis der API haben oder häufig die Proto-Referenzdokumentation für den genauen Namespace-Pfad aufrufen, um Referenzen auf Proto-Klassen abzurufen.
ProtoLookupUtil
Mit den Lookup-Hilfsmethoden für GoogleAdsClient (unterstützt von Factories und ServiceLookup, die die alte Klasse ProtoLookupUtil ersetzen) können Sie Instanzen von Diensten, Vorgängen, Aufzählungen und Ressourcen suchen und erstellen, ohne API-Versionsnummern und Modul-Namespaces im Blick behalten zu müssen. Standardmäßig wird für diese Methoden die höchste API-Version verwendet, die von Ihrem installierten Gem unterstützt wird (V25 im neuesten Release, wobei für untergeordnete API-Releases wie v25.1 das Modul der Hauptversion V25 verwendet wird). Sie können aber auch ein explizites Versionspräfix (z. B. v25) für den Suchaufruf angeben.
Ohne das Lookup-Dienstprogramm instanziieren Sie eine Kampagnenressource direkt aus dem zugehörigen Namespace mit Versionsangabe:
campaign =
Google::Ads::GoogleAds::V25::Resources::Campaign.new
Mit den Client-Suchmethoden können Sie die Ressource direkt über den Client instanziieren:
campaign = client.resource.campaign
Beim Abrufen einer Ressource, eines Dienstes oder eines Vorgangs wird eine Instanz dieser Entität zurückgegeben:
# Instantiate an operation
operation = client.operation.campaign
Dienstsuche
Verwenden Sie die Methode client.service, um Dienstclients abzurufen, auch wenn Sie dieses Dienstprogramm nicht für andere Entitäten verwenden. client.service konfiguriert automatisch Ihre Anmeldedaten und Transporteinstellungen für die Authentifizierung im zurückgegebenen Dienstclient:
campaign_service = client.service.campaign
Aufzählungssuche
Weisen Sie für Enum-Felder in Protobuf-Nachrichten direkt ein Ruby-Symbol zu, anstatt das Enumerationsmodul zu suchen:
campaign.status = :PAUSED
Wenn Sie alle gültigen Symbole für eine Aufzählung zur Laufzeit prüfen oder durchlaufen möchten, verwenden Sie client.enum. Damit wird die Google::Protobuf::EnumDescriptor für diese Aufzählung zurückgegeben:
status_enum = client.enum.campaign_status
status_enum.each { |status| p status }