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

לפני שתתחילו לתכנת את אפליקציית הלקוח הראשונה, כדאי לעשות כמה פעולות – אם עדיין לא עשיתם אותן.

קבל חשבון Google

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

יכול להיות שתרצו חשבון 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. בהקשר של ממשקי ה-API של Google,‏ 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.

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

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

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