API の使用時に proto クラスへの参照を取得するには、API の本質的な知識を持っているか、正確なパスについて proto リファレンス ドキュメントを頻繁に調べる必要があります。
ProtoLookupUtil
proto 参照ユーティリティを使用すると、API のバージョン番号と名前空間を追跡することなく、サービス、オペレーション、列挙型、リソースのインスタンスを検索して作成できます。
キャンペーンのインスタンス化方法は通常、以下のとおりです。
campaign = Google::Ads::GoogleAds::V16::Resources::Campaign.new
proto lookup ユーティリティを使用すると、より簡単なフォームを使用できます。
campaign = client.resource.campaign
リソース、サービス、オペレーションをフェッチすると、そのエンティティのインスタンスが返されます。列挙型を取得すると、インスタンス化なしでクラスへの参照が返されます。
列挙型の場合は、ショートカットを使用することで、列挙型 proto を検索する必要がなくなります。
campaign.status = :PAUSED
他のユースケースでこのユーティリティを使用しない場合でも、client.service メソッドを使用してサービスを取得することをおすすめします。このメソッドには、開発者トークンと認証情報を渡す追加のロジックが組み込まれています。別の方法を使用した場合は、これらを手動で処理する必要があります。