查找 Util

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

ProtoLookupUtil

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

您通常会按如下方式实例化广告系列:

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

不过,借助 proto 查找实用程序,您可以使用更简单的表单:

campaign = client.resource.campaign

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

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

campaign.status = :PAUSED

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