Mengambil referensi ke class proto saat menggunakan API mengharuskan Anda memiliki pemahaman mendalam tentang API atau sering mencari dokumentasi referensi proto untuk mengetahui 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 Anda membuat instance kampanye:
campaign = Google::Ads::GoogleAds::V20::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 akan ditampilkan. Saat mengambil enumerasi, referensi ke class akan ditampilkan, tanpa instansiasi.
Untuk enumerasi, Anda dapat menggunakan pintasan untuk melewati kebutuhan 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 dibuat ke dalam metode ini untuk meneruskan token developer dan detail autentikasi Anda, yang harus Anda tangani secara manual jika menggunakan metode lain.