לפני שתתחילו לתכנת את אפליקציית הלקוח הראשונה, כדאי לעשות כמה פעולות – אם עדיין לא עשיתם אותן.
קבל חשבון Google
כדי ליצור פרויקט ב-Google API Console, צריך חשבון Google. אם כבר יש לכם חשבון, הכול מוכן.
יכול להיות שתרצו גם חשבון Google נפרד למטרות בדיקה.
רוצה לנסות את דוח חוויית הצופים במודעות של Google?
מאמרי העזרה של ה-API מבוססים על ההנחה שכבר השתמשתם בדוח חוויית השימוש במודעות של Google, ושאתם מכירים את המושגים של תכנות לאינטרנט ואת פורמטים של נתונים באינטרנט.
אם לא השתמשתם בעבר בדוח חוויית המשתמש ב-Google Ads, מומלץ לנסות את ממשק המשתמש לפני שתתחילו לתכנת.
יצירת פרויקט עבור הלקוח
לפני ששולחים בקשות ל-Google Ad Experience Report, צריך לספר ל-Google על הלקוח ולהפעיל גישה ל-API. כדי לעשות זאת, משתמשים ב-Google API Console כדי ליצור פרויקט, שהוא אוסף בעל שם של הגדרות ופרטי גישה ל-API, ורושמים את האפליקציה.
העקרונות הבסיסיים של REST
יש שתי דרכים להפעיל את ה-API:
- שליחה של בקשות HTTP וניתוח התגובות.
- שימוש בספריות לקוח.
אם תחליטו לא להשתמש בספריות לקוח, תצטרכו להכיר את העקרונות הבסיסיים של 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 ב-Google Ad Experience Report API
הפעולות של Google Ad Experience Report API ממופות ישירות לפעלים מסוג REST HTTP.
אלה הם הפורמטים הספציפיים למזהי URI של Google Ad Experience Report API:
https://adexperiencereport.googleapis.com/v1/resourcePath?parameters
הקבוצה המלאה של מזהי URI שמשמשים לכל פעולה נתמכת ב-API מסוכמת במסמך Google Ad Experience Report API Reference.
העקרונות הבסיסיים של JSON
הנתונים שמוחזרים מ-Google Ad Experience Report API הם בפורמט JSON.
JSON (JavaScript Object Notation) הוא פורמט נתונים נפוץ בלתי תלוי בשפה, שמספק ייצוג טקסט פשוט של מבני נתונים שרירותיים. למידע נוסף: json.org.