検索ユーティリティ

API の使用時に proto クラスへの参照を取得するには、API の本質を理解しているか、正確なパスを確認するために proto リファレンス ドキュメントを頻繁に参照する必要があります。

ProtoLookupUtil

proto ルックアップ ユーティリティを使用すると、API バージョン番号と Namespace を追跡しなくても、サービス、オペレーション、列挙型、リソースのインスタンスを検索して作成できます。

通常、キャンペーンをインスタンス化する方法は次のとおりです。

campaign = Google::Ads::GoogleAds::V19::Resources::Campaign.new

ただし、proto ルックアップ ユーティリティを使用すると、よりシンプルな形式を使用できます。

campaign = client.resource.campaign

リソース、サービス、オペレーションを取得すると、そのエンティティのインスタンスが返されます。列挙型を取得すると、クラスへの参照が返され、インスタンス化は行われません。

列挙型の場合は、ショートカットを使用して列挙型プロトコルを検索する必要がなくなります。

campaign.status = :PAUSED

他のユースケースでこのユーティリティを使用しない場合でも、client.service メソッドを使用してサービスを取得することをおすすめします。このメソッドには、デベロッパー トークンと認証の詳細を渡すための追加ロジックが組み込まれています。これは、別のメソッドを使用した場合は手動で処理する必要があります。