חיפוש מידע

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

ProtoLookupUtil

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

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

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

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

campaign = client.resource.campaign

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

במקרים של ספירות, אפשר להשתמש בקיצור דרך כדי לא לחפש את פרוטוקולי הספירה.

campaign.status = :PAUSED

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