Perl クライアント ライブラリ

Perl クライアント ライブラリは GitHub でホストされ、パッケージは CPAN で入手できます。

このライブラリは、Perl バージョン 5.28.1 以降をサポートしています。

REST API プロトコル

Perl クライアント ライブラリのクラス エンティティ(サービス、リソース、列挙型、エラーなど)は、プロトコル バッファ定義を解析して生成されます。構造化データのシリアル化方法について詳しくは、プロトコル バッファのドキュメントをご覧ください。

Google Ads API に接続するために、クライアント ライブラリは JSON で HTTP リクエストを作成し、HTTP 1.1 経由で REST エンドポイントに送信します。レスポンスを JSON オブジェクトとしてデシリアライズし、結果を解釈します。

ライブラリをインストールする

Perl クライアント ライブラリは GitHub でホストされ、CPAN を使用して配布されます。

  1. GitHub からライブラリのクローンを作成します。

    git clone https://github.com/googleads/google-ads-perl.git
    
  2. google-ads-perl ディレクトリに移動します。

    cd google-ads-perl
    

    いくつかのファイルとサブディレクトリが表示されます。

    • Build.PL: Perl ビルドファイル。このプロジェクトの依存関係とテストタイプを保持します。
    • lib: ライブラリのソースコード。
    • t: ライブラリ コードのテストケース。
    • examples: Google Ads API を使用して一般的なユースケースを実行する方法を示す多くの例。
    • googleads.properties: ライブラリのサンプル構成ファイル。
    • log4perl.conf: サンプル ロギング構成ファイル。
  3. 必要な依存関係をインストールして、ライブラリをビルドします。Build.PL ファイルには、ライブラリに必要なすべての依存関係がリストされています。これらをインストールするには、次のコマンドを実行します。

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

最初の API 呼び出しを実行する

Google Ads API を使用するには、API へのアクセス権を取得し、Google 広告アカウントを設定する手順をいくつか行う必要があります。クイック スタートガイドに沿って、Google 広告アカウントの設定など、重要な手順をすべて確認します。

基本的な使用方法

Perl クライアント ライブラリの使用方法について詳しくは、基本的な使用方法のガイドをご覧ください。

認証と認可

Perl クライアント ライブラリは、認証と認可に対する複数のアプローチをサポートしています。詳細については、認証と認可のガイドをご覧ください。

構成とロギング

Perl クライアント ライブラリは、構成に googleads.properties を使用し、ロギングに log4perl.conf を使用します。これらのファイルを変更して、ライブラリの動作をカスタマイズできます。詳細については、構成ガイドとロギングガイドをご覧ください。

ユーティリティ

Perl クライアント ライブラリには、API の使いやすさを向上させるユーティリティ クラスが含まれています。詳細については、次のガイドをご覧ください。

アプリケーションのパフォーマンスを微調整する

アプリケーションのパフォーマンスを微調整する方法については、パフォーマンス ガイドをご覧ください。