検索ユーティリティ

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

ProtoLookupUtil

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

通常、キャンペーンは次のようにインスタンス化されます。

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

ただし、proto 検索ユーティリティを使用すると、より簡単な形式を使用できます。

campaign = client.resource.campaign

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

列挙型の場合、ショートカットを使用して列挙型プロトコルを検索する必要を回避できます。

campaign.status = :PAUSED

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