Mengambil referensi ke class proto saat menggunakan API mengharuskan Anda memiliki pemahaman intrinsik tentang API atau sering mencari dokumentasi referensi proto untuk jalur yang tepat.
ProtoLookupUtil
Utilitas pencarian proto memungkinkan Anda mencari dan membuat {i>instance<i} layanan, operasi, enumerasi, dan resource tanpa harus melacak API nomor versi, dan namespace.
Berikut ini cara biasanya membuat instance kampanye:
campaign = Google::Ads::GoogleAds::V17::Resources::Campaign.new
Namun, dengan utilitas pencarian proto, Anda dapat menggunakan bentuk yang lebih sederhana:
campaign = client.resource.campaign
Saat mengambil resource, layanan, atau operasi, instance entity tersebut dikembalikan. Saat mengambil enumerasi, referensi ke class akan ditampilkan, tanpa membuat instance.
Untuk enumerasi, Anda bisa menggunakan pintasan untuk mengabaikan keharusan mencari proto enumerasi.
campaign.status = :PAUSED
Sebaiknya gunakan metode client.service untuk mengambil layanan meskipun Anda
jangan gunakan utilitas ini untuk kasus penggunaan lainnya. Ada logika tambahan
yang dibangun dalam
metode ini untuk meneruskan token developer dan detail autentikasi Anda,
Anda harus menanganinya secara
manual jika Anda menggunakan metode lain.