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 dei buffer di protocollo. Per scoprire di più su come vengono serializzati i dati strutturati, consulta la documentazione sui 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 tramite CPAN.

Installa da CPAN

Installa la distribuzione Google::Ads::GoogleAds::Client direttamente da CPAN utilizzando cpanm (o cpan):

cpanm Google::Ads::GoogleAds::Client

Crea dal codice sorgente ed esegui gli esempi

Per eseguire gli esempi di codice inclusi o creare la libreria dal codice sorgente:

  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: scenari 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 e crea la libreria. 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
./Build installdeps
./Build
./Build install

Fai 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. Segui la guida rapida, che ti illustra tutti i passaggi importanti, tra cui la configurazione degli account Google Ads.

Utilizzo di base

Inizializza Google::Ads::GoogleAds::Client (che carica le credenziali da ~/googleads.properties o GOOGLE_ADS_CONFIGURATION_FILE_PATH per impostazione predefinita) e trasmetti in streaming le righe della campagna utilizzando SearchStreamHandler:

use strict;
use warnings;
use Google::Ads::GoogleAds::Client;
use Google::Ads::GoogleAds::Utils::SearchStreamHandler;
use Google::Ads::GoogleAds::V26::Services::GoogleAdsService::SearchGoogleAdsStreamRequest;

my $api_client = Google::Ads::GoogleAds::Client->new();
my $google_ads_service = $api_client->GoogleAdsService();

my $search_stream_request =
  Google::Ads::GoogleAds::V26::Services::GoogleAdsService::SearchGoogleAdsStreamRequest
  ->new({
    customerId => "INSERT_CUSTOMER_ID_HERE",
    query      =>
      "SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id"
  });

my $search_stream_handler =
  Google::Ads::GoogleAds::Utils::SearchStreamHandler->new({
    service => $google_ads_service,
    request => $search_stream_request
  });

$search_stream_handler->process_contents(
  sub {
    my $google_ads_row = shift;
    printf "Campaign with ID %d and name '%s' was found.\n",
      $google_ads_row->{campaign}{id},
      $google_ads_row->{campaign}{name};
  });

Per saperne di più su come utilizzare la libreria client Perl, consulta la guida all'utilizzo di base.

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 le guide alla configurazione e al logging.

Utilità

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

Ottimizza le prestazioni delle applicazioni

Consulta la guida alle prestazioni per suggerimenti su come ottimizzare le prestazioni della tua applicazione.