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

Le entità classe, come servizio, risorsa, enum ed errore, nella libreria client Perl vengono generate analizzando le definizioni del buffer di protocollo. Per scoprire di più su come vengono serializzati i dati strutturati, consulta la documentazione del buffer del 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 compilazione 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 di logging di esempio.

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

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

Esegui la tua prima chiamata API

Per utilizzare l'API Google Ads, devi eseguire diversi passaggi per ottenere l'accesso all'API e configurare i tuoi account Google Ads. Ti consigliamo di seguire la guida rapida, che ti guiderà in 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 il logging. Puoi modificare questi file per personalizzare il comportamento della libreria. Per saperne di più, consulta la guida Registrazione.

Utilità

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

Ottimizzare le prestazioni dell'applicazione

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