लुकअप यूटिलिटी

एपीआई का इस्तेमाल करते समय, प्रोटो क्लास के रेफ़रंस पाने के लिए, यह ज़रूरी है कि आपको एपीआई की पूरी जानकारी हो या नेमस्पेस के सटीक पाथ के लिए, प्रोटो रेफ़रंस से जुड़े दस्तावेज़ को बार-बार देखना पड़ता हो.

ProtoLookupUtil

GoogleAdsClient पर लुकअप यूटिलिटी के तरीके (फ़ैक्ट्री और ServiceLookup की मदद से, पुराने ProtoLookupUtil क्लास की जगह) आपको एपीआई वर्शन नंबर और मॉड्यूल नेमस्पेस को ट्रैक किए बिना, सेवाओं, कार्रवाइयों, इन्यूमरेशन, और संसाधनों के इंस्टेंस को देखने और बनाने की सुविधा देते हैं. डिफ़ॉल्ट रूप से, ये तरीके इंस्टॉल किए गए जेम (V26 के सबसे नए रिलीज़ में, जहां v25.1 जैसे छोटे एपीआई वर्शन, अपने मेजर वर्शन मॉड्यूल V25 का इस्तेमाल करते हैं) के साथ काम करने वाले सबसे नए एपीआई वर्शन का इस्तेमाल करते हैं. इसके अलावा, लुकअप कॉल पर, वर्शन का प्रीफ़िक्स (जैसे, v26) भी तय किया जा सकता है.

लुकअप यूटिलिटी के बिना, कैंपेन रिसॉर्स को सीधे उसके वर्शन वाले नेमस्पेस से इंस्टैंशिएट किया जाता है:

campaign =
  Google::Ads::GoogleAds::V26::Resources::Campaign.new

क्लाइंट लुकअप के तरीकों से, रिसॉर्स को सीधे क्लाइंट से इंस्टैंशिएट किया जा सकता है:

campaign = client.resource.campaign

किसी रिसॉर्स, सेवा या कार्रवाई को फ़ेच करने पर, उस इकाई का इंस्टेंस दिखता है:

# Instantiate an operation
operation = client.operation.campaign

सेवा का लुकअप

सेवा क्लाइंट को फ़ेच करने के लिए, client.service तरीके का इस्तेमाल करें. भले ही, अन्य इकाइयों के लिए इस यूटिलिटी का इस्तेमाल न किया जा रहा हो. client.service , दिखाए गए सेवा क्लाइंट पर, आपके पुष्टि करने वाले क्रेडेंशियल और ट्रांसपोर्ट सेटिंग को अपने-आप कॉन्फ़िगर करता है:

campaign_service = client.service.campaign

इन्यूमरेशन का लुकअप

प्रोटोबफ़ मैसेज में enum फ़ील्ड के लिए, इन्यूमरेशन मॉड्यूल को देखने के बजाय, सीधे तौर पर Ruby सिंबल असाइन करें:

campaign.status = :PAUSED

रनटाइम पर, किसी इन्यूमरेशन के सभी मान्य सिंबल की जांच करने या उन्हें दोहराने के लिए, client.enum का इस्तेमाल करें. इससे उस enum के लिए, Google::Protobuf::EnumDescriptor दिखता है:

status_enum = client.enum.campaign_status
status_enum.each { |status| p status }