Utilizzo di base

L'utilizzo di base della libreria client è il seguente:

Installazione

Il modo consigliato per installare la libreria è utilizzare Bundler. Aggiungi una riga al tuo Gemfile (sostituendo x.y.z con il numero di versione che vuoi utilizzare):

gem 'google-ads-googleads', '~> x.y.z'

Dopodiché, esegui:

bundle install

Questo comando utilizza Bundler per aggiornare il file Gemfile.lock, bloccando la versione esatta del gem e tutte le dipendenze del gem installate. L'operatore di versione pessimista "~> x.y.z" garantisce che bundle install o bundle update installi solo nuove versioni patch nella serie x.y.*, quindi devi attivare manualmente le nuove versioni secondarie o principali aggiornando Gemfile.

Altre opzioni di installazione

Se non utilizzi Bundler, puoi utilizzare una di queste opzioni:

  1. Installa questa libreria utilizzando RubyGems:

    gem install google-ads-googleads

  2. Scarica il gem dalla pagina delle release e installalo dal file locale:

    gem install google-ads-googleads-[version].gem

Configura l'autenticazione

Per autenticare le chiamate API, configura il file google_ads_config.rb e segui le istruzioni riportate nella pagina Autenticazione e autorizzazione.

Utilizzo

A partire dalla versione 41.1.0 di google-ads-googleads, la gemma supporta l'autorequire di Bundler (Bundler.require). Nelle versioni precedenti alla 41.1.0 (o quando non si utilizza Bundler.require), richiedi esplicitamente la gemma nel codice:

require 'google/ads/google_ads'

Inizializza il client (che carica la configurazione da ~/google_ads_config.rb per impostazione predefinita) e recupera un servizio specifico, ad esempio CampaignService:

# Initialize the client using ~/google_ads_config.rb.
client = Google::Ads::GoogleAds::GoogleAdsClient.new

# Fetch the CampaignService client.
campaign_service = client.service.campaign

Per dimostrazioni più dettagliate su come utilizzare la libreria, consulta gli esempi su GitHub.

Dopo aver familiarizzato con gli esempi, esplora le factory, che forniscono un insieme di metodi di convenienza di alto livello per lavorare con l'API Google Ads.

Gestione degli errori

Non tutte le chiamate API vanno a buon fine. Il server genera eccezioni se le chiamate API non vanno a buon fine. È importante acquisire gli errori API e gestirli in modo appropriato.

Un'istanza Google::Ads::GoogleAds::Errors::GoogleAdsError viene generata quando si verifica un errore API. Contiene dettagli che ti aiutano a determinare cosa è andato storto e puoi configurare una funzione helper per gestire gli errori. Visualizza un esempio di gestore di errori su GitHub.