דרישות מוקדמות

קבל חשבון Google

כדי ליצור פרויקט ב-Google API Console, צריך חשבון Google. אם כבר יש לכם חשבון, הכול מוכן.

אולי תרצו גם חשבון Google נפרד למטרות בדיקה.

התנסות ב-Google AdMob

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

אם לא השתמשתם ב-Google AdMob, לפני שתתחילו לתכנת אנחנו ממליצים לנסות את ממשק המשתמש.

יצירת פרויקט עבור הלקוח

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

כדי להתחיל להשתמש ב-AdMob API, קודם צריך להשתמש בכלי ההגדרה, שמדריך אתכם בתהליך של יצירת פרויקט ב-Google API Console והפעלת ה-API.

העקרונות הבסיסיים של REST

‫REST הוא סגנון של ארכיטקטורת תוכנה שמציע תפיסה נוחה ועקבית לבקשת נתונים ולשינוי שלהם.

המונח REST הוא קיצור של Representational State Transfer. בהקשר של Google APIs,‏ REST מתייחס לשימוש בפעלים של HTTP כדי לאחזר ולשנות ייצוגים של נתונים ש-Google מאחסנת.

במערכת RESTful, המשאבים מאוחסנים במאגר נתונים. לקוח שולח בקשה לשרת לבצע פעולה מסוימת (כמו יצירה, אחזור, עדכון או מחיקה של משאב), והשרת מבצע את הפעולה ושולח תגובה – לרוב בצורת ייצוג של המשאב שצוין.

בממשקי RESTful API של Google, הלקוח מציין פעולה באמצעות פועל של HTTP כמו POST,‏ GET,‏ PUT או DELETE. הוא מציין משאב לפי URI ייחודי גלובלי, באופן הבא:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

בגלל שלכל משאבי ה-API יש מזהה URI ייחודי שניתן לגשת אליו באמצעות HTTP,‏ ב-REST אפשר לשמור נתונים במטמון והוא מותאם לעבודה עם התשתית המבוזרת של האינטרנט.

תוכלו להיעזר בהגדרות השיטה במסמכי התיעוד של תקני HTTP 1.1 – הן כוללות מפרטים של GET,‏ POST,‏ PUT ו-DELETE.

‫REST ב-AdMob API

הפעולות של AdMob API ממופות ישירות לפעלים מסוג REST HTTP.

אלה הם הפורמטים שספציפיים למזהי URI של AdMob API:

https://admob.googleapis.com/v1/resourcePath?parameters

הקבוצה המלאה של מזהי URI שמשמשים לכל פעולה נתמכת ב-API מסוכמת במסמך AdMob API Reference.

העקרונות הבסיסיים של JSON

ב-AdMob API הנתונים מוחזרים בפורמט JSON.

‫JSON‏ (JavaScript Object Notation) הוא פורמט נתונים נפוץ בלתי תלוי בשפה, שמספק ייצוג טקסט פשוט של מבני נתונים שרירותיים. למידע נוסף היכנסו לאתר של json.org.