查找 Util

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

ProtoLookupUtil

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

通常,您可以通过以下方法实例化广告系列:

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

但是,借助 proto 查找实用程序,您可以使用更简单的形式:

campaign = client.resource.campaign

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

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

campaign.status = :PAUSED

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