查詢公用程式

使用 API 時,如果要擷取對 Proto 類別的參照,您必須對 API 有內在的瞭解,或是需要經常查詢 Proto 參照說明文件,才能取得確切路徑。

ProtoLookupUtil

您可以使用 proto 查詢工具,查詢及建立服務、作業、列舉和資源的例項,而無須追蹤 API 版本號碼和命名空間。

以下是一般實例化廣告活動的方式:

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

不過,您可以使用 proto 查詢工具,使用更簡單的形式:

campaign = client.resource.campaign

擷取資源、服務或作業時,系統會傳回該實體的例項。擷取列舉時,系統會傳回類別的參照,但不會執行例項化。

對於列舉,您可以使用捷徑,無須查詢列舉原型。

campaign.status = :PAUSED

即使您不會將此公用程式用於其他用途,仍建議您使用 client.service 方法擷取服務。這個方法內建額外的邏輯,可傳遞開發人員權杖和驗證詳細資料,如果您使用其他方法,就必須手動處理這些資料。