Libreria client Perl

La libreria client Perl è ospitata su GitHub e il pacchetto è disponibile su CPAN.

La libreria supporta Perl versione 5.28.1 o successive.

Protocollo API REST

Nota: l'API Google Ads espone sia endpoint REST JSON standard sia un'interfaccia gRPC ad alte prestazioni. Poiché Perl non è un linguaggio supportato nello stack gRPC, questa libreria client è implementata sul protocollo JSON REST su HTTP 1.1.

Le entità di classe, come servizio, risorsa, enum ed errore, nella libreria client Perl vengono generate analizzando le definizioni dei buffer di protocollo. Per scoprire di più su come vengono serializzati i dati strutturati, consulta la documentazione del buffer di protocollo.

Per connettersi all'API Google Ads, la libreria client crea una richiesta HTTP in JSON, la invia all'endpoint REST tramite HTTP 1.1, deserializza la risposta come oggetto JSON e interpreta i risultati.

Installa la libreria

La libreria client Perl è ospitata su GitHub e distribuita utilizzando CPAN.

1. Clona la libreria da GitHub:

   git clone https://github.com/googleads/google-ads-perl.git
   

2. Passa alla directory google-ads-perl:

   cd google-ads-perl
   

   Vedrai alcuni file e sottodirectory:

   • Build.PL: il file di build Perl, che contiene le dipendenze e i tipi di test di questo progetto.
   • lib: il codice sorgente della libreria.
   • t: casi di test del codice della libreria.
   • examples: molti esempi che mostrano come utilizzare la libreria per eseguire casi d'uso comuni utilizzando l'API Google Ads.
   • googleads.properties: il file di configurazione di esempio per la libreria.
   • log4perl.conf: il file di configurazione della registrazione di esempio.

3. Installa le dipendenze richieste e crea la libreria. Il file Build.PL elenca tutte le dipendenze richieste per la libreria. Puoi installarli eseguendo questi comandi:

   cpan install Module::Build
   perl Build.PL
   ./Build installdeps
   ./Build
   ./Build install
   

Nota: ogni release di Google::Ads::GoogleAds::Client raggruppa moduli di versioni specifiche dell'API Google Ads in lib/Google/Ads/GoogleAds/ (dove le release secondarie dell'API, come v25.1, sono incluse nel modulo della versione principale, V25). Consulta la tabella delle versioni dell'API supportate per la compatibilità delle versioni.

Fai la tua prima chiamata API

Per utilizzare l'API Google Ads, devi eseguire diversi passaggi per accedere all'API e configurare i tuoi account Google Ads. Segui la guida rapida, che ti illustra tutti i passaggi importanti, inclusa la configurazione degli account Google Ads.

Utilizzo di base

Consulta la guida all'utilizzo di base per scoprire di più su come utilizzare la libreria client Perl.

Autenticazione e autorizzazione

La libreria client Perl supporta diversi approcci all'autenticazione e all'autorizzazione. Per saperne di più, consulta la guida Autenticazione e autorizzazione.

Configurazione e logging

La libreria client Perl utilizza googleads.properties per la configurazione e log4perl.conf per la registrazione. Puoi modificare questi file per personalizzare il comportamento della libreria. Per saperne di più, consulta le guide Configurazione e Logging.

Utilità

La libreria client Perl include classi di utilità per migliorare l'usabilità dell'API. Per saperne di più, consulta le seguenti guide:

• Maschere dei campi
• Nomi delle risorse

Ottimizzare le prestazioni dell'applicazione

Consulta la Guida al rendimento per suggerimenti su come ottimizzare le prestazioni della tua applicazione.