תחילת העבודה עם ה-API של AdMob

חשוב: ההרשאות ותפקידים חדשים של משתמשים ישפיעו על הנתונים שיוחזרו על ידי AdMob API. מידע נוסף

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

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

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

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

• חשבון Google.

• חשבון Google AdMob.

• היכרות עם היסודות של REST ואישור בקשות באמצעות OAuth 2.0.

קביעת סוג האימות

בטבלה שבהמשך תוכלו לראות איזה סוג אימות הכי מתאים לאפליקציה שלכם:

בחירת סוג האימות של OAuth2	אם ...
אפליקציה למחשב	הניהול של כל חשבונות AdMob API מתבצע באמצעות חשבון ניהול יחיד ברמה עליונה. אם זו הפעם הראשונה שלך, או שברצונך להתחיל במהירות עם ההגדרה הפשוטה ביותר. האפליקציה שלכם מאמתת משתמשי Google AdMob רק ממחשב אחד.
אפליקציית אינטרנט	ברצונך לבצע אימות כמשתמש שיכול להעניק לאפליקציה שלך הרשאת גישה לנתונים שלו בחשבון AdMob API. כדאי ליצור בקלות פרטי כניסה מרובים להרשאות, למשל כדי לנהל חשבונות של צד שלישי. לאפליקציה שלך נדרשות כתובות URL לקריאה חוזרת (callback). כתובות URL לקריאה חוזרת לא נתמכות בתהליך של האפליקציה למחשב.

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

יוצרים פרויקט

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

הפעלת ה-API לפרויקט קיים

השלבים הבאים רלוונטיים למשתמשים שיש להם פרויקט קיים שמעדיפים להפעיל עבורו את AdMob API באופן ידני.

כדי לאפשר ממשק API לפרויקט שלך:

1. Open the API Library ב Google API Console .
2. If prompted, select a project, or create a new one. API Library מפרט את כל ה- APIs הזמינים, מקובצים לפי משפחת מוצרים ופופולריות.
3. אם ממשק ה- API שברצונך להפעיל אינו גלוי ברשימה, השתמש בחיפוש כדי למצוא אותו או לחץ על הצג הכל במשפחת המוצרים שאליה הוא שייך.
4. בחר בממשק ה- API שברצונך להפעיל ולחץ על כפתור הפעל .
5. If prompted, enable billing.
6. If prompted, read and accept the API's Terms of Service.

יצירת פרטי כניסה של OAuth2

בהוראות הבאות מוסבר איך ליצור מזהה לקוח ב-OAuth 2.0 לשימוש בתהליך האפליקציה שהותקנה.

1. Go to the Credentials page.

2. לוחצים על CREATE CREDENTIALS > OAuth Client ID.

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

   1. מגדירים את סוג המשתמש כExternal ואת סטטוס הפרסום ל-Publish (פורסם).

   2. לחלופין, מגדירים את סוג המשתמש כExternal ואת סטטוס הפרסום לבדיקה, ומוסיפים את האפשרות משתמשים לבדיקה על ידי בחירה באפשרות הוספת משתמשים כדי לתת להם הרשאת גישה לשימוש במזהה הלקוח שלכם ב-OAuth 2.0.

      למידע נוסף על הגדרת מסך ההסכמה ל-OAuth.

3. בוחרים את סוג האפליקציה אפליקציית שולחן העבודה או אפליקציית אינטרנט, נותנים לה שם ולוחצים על יצירה.

בסיום התהליך יוצגו לכם מזהה לקוח וסוד לקוח של OAuth 2.0, שאפשר להוריד בפורמט JSON ולשמור אותם לשימוש במועד מאוחר יותר.

יצירת בקשה

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

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

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

היקף	משמעות
https://www.googleapis.com/auth/admob.readonly	הצגת כל הנתונים ב-AdMob. הנתונים האלה יכולים לכלול פרטי חשבון, הגדרות של מלאי שטחי פרסום ותהליך בחירת הרשת (Mediation), דוחות ונתונים אחרים. לא ייקרא מידע אישי רגיש כמו פרטי תשלומים או פרטי קמפיינים.
https://www.googleapis.com/auth/admob.report	לראות את דוחות הרווחים וביצועי המודעות. הצגת מזהה בעל האפליקציה, אזור הזמן וקוד המטבע שמוגדר כברירת מחדל.

הבקשה הראשונה ליצירת דוח מתבצעת באמצעות דוגמאות ב-Java, PHP, Python או curl.

ביטול אסימונים משותפים

יש שתי דרכים לבטל אסימונים משותפים:

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

2. לחלופין, אפשר לבטל אסימונים של אפליקציות אינטרנט באמצעות Google Identity API.