מתאמים

ב-AdMob API יש אפשרות להציג מתאמים לתהליך בחירת הרשת (Mediation) באופן פרוגרמטי. למידע נוסף, ראו 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"
        }]
     }]
   }