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
    perl Build installdeps
    

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

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

基本的な使用方法

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

認証と認可

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

構成とロギング

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

ユーティリティ

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

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

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