מתאמים

ב-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"
        }]
     }]
   }