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 のユーザビリティを向上させるユーティリティ クラスが含まれています。詳細については、次のガイドをご覧ください。

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

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