एपीआई का इस्तेमाल करते समय, प्रोटो क्लास के रेफ़रंस फ़ेच करने के लिए, यह ज़रूरी है कि आपके पास एपीआई की अच्छी समझ हो या आपको सटीक पाथ के लिए, प्रोटो रेफ़रंस दस्तावेज़ को बार-बार देखना पड़े.
ProtoLookupUtil
प्रोटो लुकअप टूल की मदद से, सेवाओं, ऑपरेशन, एनोटेशन, और संसाधनों के इंस्टेंस को खोजा और बनाया जा सकता है. इसके लिए, एपीआई वर्शन नंबर और नेमस्पेस को ट्रैक करने की ज़रूरत नहीं होती.
आम तौर पर, कैंपेन को इंस्टैंशिएट करने का तरीका यहां बताया गया है:
campaign = Google::Ads::GoogleAds::V19::Resources::Campaign.new
हालांकि, प्रोटो लुकअप यूटिल की मदद से, एक आसान फ़ॉर्म का इस्तेमाल किया जा सकता है:
campaign = client.resource.campaign
किसी संसाधन, सेवा या ऑपरेशन को फ़ेच करने पर, उस इकाई का एक इंस्टेंस दिखाया जाता है. एनोटेशन फ़ेच करने पर, क्लास का रेफ़रंस दिखाया जाता है, लेकिन उसे इंस्टैंशिएट नहीं किया जाता.
एनोटेशन के लिए, शॉर्टकट का इस्तेमाल करके एनोटेशन प्रोटो को खोजने की ज़रूरत नहीं होती.
campaign.status = :PAUSED
हमारा सुझाव है कि सेवाओं को फ़ेच करने के लिए, client.service
तरीके का इस्तेमाल करें. भले ही, आपने इस सुविधा का इस्तेमाल किसी दूसरे उदाहरण के लिए न किया हो. इस तरीके में, आपके डेवलपर टोकन और पुष्टि करने की जानकारी को पास करने के लिए अतिरिक्त लॉजिक जोड़ा गया है. अगर किसी दूसरे तरीके का इस्तेमाल किया जाता है, तो आपको मैन्युअल तरीके से जानकारी देनी होगी.