查找 Util

如果要在使用 API 时提取对 proto 类的引用,您需要对 API 有固有的了解,或者需要经常查找 proto 参考文档以获取确切路径。

ProtoLookupUtil

借助 proto lookup util,您可以查找和创建服务、操作、枚举和资源的实例,而无需跟踪 API 版本号和命名空间。

以下是实例化广告系列通常的方法:

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

但是,使用 proto lookup util,您可以使用更简单的形式:

campaign = client.resource.campaign

提取资源、服务或操作时,系统会返回该实体的一个实例。提取枚举时,系统会返回对类的引用,而不会进行实例化。

对于枚举,您可以使用快捷方式来绕过查找枚举 proto 的需求。

campaign.status = :PAUSED

即使您没有将此实用程序用于任何其他用例,我们还是建议您使用 client.service 方法来提取服务。此方法中内置了额外的逻辑来传递开发者令牌和身份验证详细信息,如果您使用其他方法,则必须手动处理这些逻辑。