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à di classe, come servizio, risorsa, enum ed errore, nella libreria client Perl vengono generate analizzando le definizioni del buffer di protocollo. Per saperne 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 su HTTP 1.1, deserializza la risposta come oggetto JSON e interpreta i risultati.

Installare la libreria

La libreria client Perl è ospitata su GitHub e distribuita tramite 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

    Verranno visualizzati alcuni file e sottodirectory:

    • Build.PL: il file di build Perl, che contiene le dipendenze e i tipi di test di questo progetto.
    • lib: 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 installarle eseguendo i seguenti comandi:

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

Eseguire la prima chiamata API

Per utilizzare l'API Google Ads, devi eseguire diversi passaggi per accedere 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 saperne 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 al Logging.

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 alle prestazioni per i consigli su come ottimizzare le prestazioni dell'applicazione.