מתאמים

‫AdMob API יכול להציג מתאמים של תהליך בחירת הרשת באופן פרוגרמטי. מידע נוסף זמין במאמר accounts.adSources.adapters.list. המתאמים כוללים פרטים על ההגדרות של מתאמים של צד שלישי.

דוגמאות

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

הפרטים לגבי היקפי OAuth 2.0:

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

‫curl (שורת פקודה)

בקשות באמצעות curl

1. טוענים את קובץ סודות הלקוח ויוצרים פרטי הרשאה.

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

   לצורך אימות ומתן הרשאות, מומלץ להשתמש ב-oauth2l, כלי שורת פקודה פשוט לעבודה עם Google OAuth 2.0. מתקינים את oauth2l ומריצים את הפקודה שלמטה, ומחליפים את path_to_credentials_json בנתיב לקובץ credentials.json שהורדתם כשנרשמתם לאפליקציית הענן. בהרצה הראשונה, הפקודה תדריך אתכם בתהליך ההרשאה של OAuth 2.0. בהרצות הבאות, האסימון יתעדכן אוטומטית.

   oauth2l header --json path_to_credentials_json --scope admob.readonly
   

2. מציינים את המתאמים.

   כדי לקבל מידע על מתאם AdMob, מחליפים את pub-XXXXXXXXXXXXXXXX במזהה בעל האפליקציה. כך מאתרים את מזהה בעל האפליקציה.

   מחליפים את SSSSSSSSSSSSSSSSSSSS במזהה של מקור המודעות עבור המתאמים הרלוונטיים.

   כדי לקבל רשימה של מתאמים, משתמשים בפקודה הבאה:

   curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources/SSSSSSSSSSSSSSSSSSSS/adapters \
    -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"
   

   דוגמה לתגובה למקור המודעות של רשת AdMob עם המזהה 5450213213286189855:

   {
    "adapters": [
     {
        "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/1",
        "adapterId": "1",
        "title": "AdMob Network Android SDK",
        "platform": "ANDROID",
        "formats": ["BANNER", "INTERSTITIAL",
          "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
        "adapterConfigMetadata": [{
          "adapterConfigMetadataId": "118",
          "adapterConfigMetadataLabel": "Ad unit ID"
        }]
     },
     {
        "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/2",
        "adapterId": "2",
        "title": "AdMob Network iOS SDK",
        "platform": "ANDROID",
        "formats": ["BANNER", "INTERSTITIAL",
          "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
        "adapterConfigMetadata": [{
          "adapterConfigMetadataId": "119",
          "adapterConfigMetadataLabel": "Ad unit ID"
        }]
     }]
   }