Wenn Sie die API verwenden, müssen Sie entweder ein grundlegendes Verständnis der API haben oder häufig in der Proto-Referenzdokumentation nach dem genauen Namespace-Pfad suchen, um Verweise auf Proto-Klassen abzurufen.
ProtoLookupUtil
Mit den Such-Dienstprogrammmethoden für GoogleAdsClient (unterstützt durch 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 verwenden diese Methoden die höchste API-Version, die von Ihrem installierten Gem unterstützt wird (V26 im neuesten Release, wobei kleinere API-Releases wie v25.1 ihr Hauptversionsmodul V25 verwenden). Sie können aber auch ein explizites Versionspräfix (z. B. v26) im Suchaufruf angeben.
Ohne das Suchdienstprogramm instanziieren Sie eine Kampagnenressource direkt aus ihrem versionierten Namespace:
campaign =
Google::Ads::GoogleAds::V26::Resources::Campaign.new
Mit den Client-Suchmethoden können Sie die Ressource direkt über den Client instanziieren:
campaign = client.resource.campaign
Wenn Sie eine Ressource, einen Dienst oder einen Vorgang abrufen, 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 Authentifizierungsdaten und Transporteinstellungen auf dem zurückgegebenen Dienstclient:
campaign_service = client.service.campaign
Aufzählungssuche
Weisen Sie bei Enum-Feldern in Protobuf-Nachrichten direkt ein Ruby-Symbol zu, anstatt das Enumerationsmodul aufzurufen:
campaign.status = :PAUSED
Wenn Sie alle gültigen Symbole für eine Aufzählung zur Laufzeit prüfen oder iterieren möchten, verwenden Sie client.enum, wodurch die Google::Protobuf::EnumDescriptor für diese Aufzählung zurückgegeben wird:
status_enum = client.enum.campaign_status
status_enum.each { |status| p status }