חיפוש מידע

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

ProtoLookupUtil

הכלי לחיפוש פרוטוקולים מאפשר לחפש וליצור מופעים של שירותים, פעולות, ספירה ומשאבים בלי לעקוב אחרי מספרי הגרסאות של ממשקי ה-API ומרחבי השמות.

כך יוצרים בדרך כלל מופע של קמפיין:

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

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

campaign = client.resource.campaign

כשאוחזרים משאב, שירות או פעולה, מוחזרת מופע של הישות הזו. כשאוספים את המניין, מוחזר הפניה לכיתה, ללא יצירה של מופע.

עבור ספירה, אפשר להשתמש בקיצור דרך כדי לעקוף את הצורך בחיפוש ה-protos של הספירה.

campaign.status = :PAUSED

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