חיפוש מידע

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

ProtoLookupUtil

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

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

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

אבל, באמצעות ה-proto lookup util, תוכלו להשתמש בטופס פשוט יותר:

campaign = client.resource.campaign

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

ניתן להשתמש בקיצור דרך עבור ספירות כדי לעקוף את הצורך בחיפוש פרוטו של המספור.

campaign.status = :PAUSED

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