כלי חיפוש

כשמשתמשים ב-API, כדי לאחזר הפניות למחלקות פרוטו צריך להבין את ה-API או לעיין לעיתים קרובות במסמכי העזר של פרוטו כדי למצוא את נתיב מרחב השמות המדויק.

ProtoLookupUtil

שיטות השירות של כלי החיפוש ב-GoogleAdsClient (שמגובות על ידי Factories ו-ServiceLookup, ומחליפות את המחלקה ProtoLookupUtil מדור קודם) מאפשרות לחפש וליצור מופעים של שירותים, פעולות, ספירות ומשאבים בלי שתצטרכו לעקוב אחרי מספרי הגרסאות של ממשקי ה-API ומרחבי השמות של המודולים. כברירת מחדל, השיטות האלה משתמשות בגרסת ה-API הכי גבוהה שנתמכת על ידי ה-gem המותקן (V25 בגרסה האחרונה, כשגרסאות משניות של ה-API כמו v25.1 משתמשות במודול של הגרסה הראשית V25), או שאפשר לציין קידומת גרסה מפורשת (כמו v25) בקריאה של החיפוש.

בלי כלי החיפוש, יוצרים מופע של משאב קמפיין ישירות ממרחב השמות עם הגרסה שלו:

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

בעזרת שיטות החיפוש של הלקוח, אפשר ליצור מופע של המשאב ישירות מהלקוח:

campaign = client.resource.campaign

כשמאחזרים משאב, שירות או פעולה, מוחזרת דוגמה של הישות הזו:

# Instantiate an operation
operation = client.operation.campaign

חיפוש שירות

משתמשים בשיטה client.service כדי לאחזר לקוחות שירות, גם אם לא משתמשים בכלי הזה עבור ישויות אחרות. ‫client.service מגדיר אוטומטית את פרטי הכניסה לאימות ואת הגדרות התעבורה בלקוח השירות שהוחזר:

campaign_service = client.service.campaign

חיפוש ערכי ספירה

בשדות enum בהודעות protobuf, צריך להקצות סמל Ruby ישירות במקום לחפש את מודול ה-enum:

campaign.status = :PAUSED

כדי לבדוק או לחזור על כל הסמלים התקפים של ספירה בזמן ריצה, משתמשים ב-client.enum, שמחזירה את Google::Protobuf::EnumDescriptor של הספירה הזו:

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