查找 Util

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

ProtoLookupUtil

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

以下是实例化广告系列的典型方式:

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

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

campaign = client.resource.campaign

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

对于枚举,您可以使用快捷方式来避免查找枚举 proto。

campaign.status = :PAUSED

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