L'utilizzo di base della libreria client è il seguente:
Installazione
Il modo consigliato per installare è utilizzare Bundler. Aggiungi una riga al tuo Gemfile (sostituendo x.y.z con il numero di versione che ti interessa):
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 della gem e tutte le dipendenze della gem installate. L'
operatore di versione pessimista "~> x.y.z" fa sì che bundle update installi solo le
nuove versioni della serie x.y.*, quindi devi attivare manualmente le nuove versioni
aggiornando di nuovo il file Gemfile.
Altre opzioni di installazione
Se non utilizzi Bundler, puoi utilizzare una di queste opzioni:
- Installa questa libreria utilizzando gem:
terminal $ [sudo] gem install google-ads-googleads - Scarica la gem dalla
pagina Release e installala
dal file locale:
terminal $ [sudo] gem install google-ads-googleads-[version].gem
Configura l'autenticazione
Per autenticare le chiamate API, segui le istruzioni riportate nella pagina Autenticazione e autorizzazione.
Utilizzo
Per includere la gem nel codice:
require 'google/ads/google_ads'
Per recuperare un servizio specifico, ad esempio CampaignService:
client = Google::Ads::GoogleAds::GoogleAdsClient.new
campaign_service = client.service.campaign
Per dimostrazioni più dettagliate su come utilizzare la libreria, consulta gli esempi su GitHub.
Dopo aver acquisito familiarità con gli esempi, ti consigliamo anche di familiarizzare con 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 andranno a buon fine. Il server può generare errori se le chiamate API non vanno a buon fine per qualche motivo. È importante acquisire gli errori API e gestirli in modo appropriato.
Quando si verifica un errore API, viene generata un'istanza di GoogleAdsException. Contiene dettagli che ti aiutano a capire cosa è andato storto e puoi configurare una funzione di assistenza per gestire gli errori. Consulta un esempio di un
gestore di errori su GitHub.