Untuk mengambil referensi ke class proto saat menggunakan API, Anda harus memiliki pemahaman intrinsik tentang API atau perlu sering mencari dokumentasi referensi proto untuk mengetahui jalur yang tepat.
ProtoLookupUtil
Util pencarian proto memungkinkan Anda mencari dan membuat instance layanan, operasi, enumerasi, dan resource tanpa harus melacak nomor versi dan namespace API.
Berikut adalah cara membuat instance kampanye secara umum:
campaign = Google::Ads::GoogleAds::V19::Resources::Campaign.new
Namun, dengan utilitas pencarian proto, Anda dapat menggunakan formulir yang lebih sederhana:
campaign = client.resource.campaign
Saat mengambil resource, layanan, atau operasi, instance entity tersebut akan ditampilkan. Saat mengambil enumerasi, referensi ke class akan ditampilkan, tanpa pembuatan instance.
Untuk enumerasi, Anda dapat menggunakan pintasan untuk mengabaikan kebutuhan untuk mencari proto enumerasi.
campaign.status = :PAUSED
Sebaiknya gunakan metode client.service untuk mengambil layanan meskipun Anda
tidak menggunakan utilitas ini untuk kasus penggunaan lainnya. Ada logika tambahan yang disertakan dalam
metode ini untuk meneruskan token developer dan detail autentikasi, yang
harus Anda tangani secara manual jika menggunakan metode lain.