Perl クライアント ライブラリは GitHub でホストされ、パッケージは CPAN で入手できます。
このライブラリは、Perl バージョン 5.28.1 以降をサポートしています。
REST API プロトコル
Perl クライアント ライブラリのクラス エンティティ(サービス、リソース、列挙型、エラーなど)は、プロトコル バッファ定義を解析して生成されます。構造化データのシリアル化について詳しくは、プロトコル バッファのドキュメントをご覧ください。
Google Ads API に接続するために、クライアント ライブラリは JSON で HTTP リクエストを作成し、HTTP 1.1 経由で REST エンドポイントに送信し、レスポンスを JSON オブジェクトとしてデシリアライズして、結果を解釈します。
ライブラリをインストールする
Perl クライアント ライブラリは GitHub でホストされ、CPAN を使用して配布されます。
GitHub からライブラリのクローンを作成します。
git clone https://github.com/googleads/google-ads-perl.gitgoogle-ads-perlディレクトリに移動します。cd google-ads-perl次のようなファイルとサブディレクトリが表示されます。
Build.PL: このプロジェクトの依存関係とテストタイプを保持する Perl ビルドファイル。lib: ライブラリのソースコード。t: ライブラリ コードのテストケース。examples: ライブラリを使用して Google Ads API で一般的なユースケースを実行する方法を示す多くの例。googleads.properties: ライブラリのサンプル構成ファイル。log4perl.conf: ロギング構成ファイルのサンプル。
必要な依存関係をインストールします。
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 のユーザビリティを向上させるためのユーティリティ クラスがいくつか含まれています。詳細については、次のガイドをご覧ください。
アプリケーションのパフォーマンスを調整する
アプリケーションのパフォーマンスを微調整する方法については、パフォーマンス ガイドをご覧ください。