Untuk mengambil referensi ke class proto saat menggunakan API, Anda harus memiliki pemahaman intrinsik tentang API atau harus sering mencari dokumentasi referensi proto untuk jalur yang tepat.
ProtoLookupUtil
Utilitas pencarian proto memungkinkan Anda mencari dan membuat instance layanan, operasi, enumerasi, dan resource tanpa harus melacak nomor versi dan namespace API.
Berikut cara biasanya membuat instance kampanye:
campaign = Google::Ads::GoogleAds::V16::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.