查詢公用程式

使用 API 時,如要擷取 proto 類別的參照,您必須對 API 有深入瞭解,或是經常查詢 proto 參照說明文件,找出確切路徑。

ProtoLookupUtil

有了 Proto 查詢公用程式,您就能查詢及建立服務、作業、列舉和資源的執行個體,不必追蹤 API 版本號碼和命名空間。

以下是廣告活動的典型例項化方式:

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

不過,使用 proto 查閱公用程式時,您可以採用較簡單的形式:

campaign = client.resource.campaign

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

對於列舉,您可以使用快速鍵,略過查閱列舉原型。

campaign.status = :PAUSED

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