Method: accounts.adSources.adapters.list

הצגת רשימה של המתאמים של מקור המודעות.

בקשת HTTP

GET https://admob.googleapis.com/v1beta/{parent=accounts/*/adSources/*}/adapters

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
parent

string

חובה. ההורה שהוא הבעלים של אוסף המתאמים הזה. פורמט: accounts/{publisherId}/adSources/{adSourceId}

פרמטרים של שאילתה

פרמטרים
pageSize

integer

מספר המתאמים המקסימלי שצריך להחזיר. אם לא צוין 0, יוחזרו 10,000 מתאמים לכל היותר. הערך המקסימלי הוא 20,000; ערכים מעל 20,000 יקובצו ל-20,000.
pageToken

string

אסימון דף, שהתקבל מקריאה קודמת ב-adapters.list. צריך לספק את הכתובת הזו כדי לאחזר את הדף הבא.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

תגובה ל-ListAdaptersRequest.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "adapters": [
    {
      object (Adapter)
    }
  ],
  "nextPageToken": string
}
שדות
adapters[]

object (Adapter)

המתאם.
nextPageToken

string

היא משמשת להגדרת pageToken ב-ListAdapterRequest לאחזור הדף הבא. אם השדה הזה יושמט, אין דפים נוספים.

היקפי ההרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/admob.monetization
  • https://www.googleapis.com/auth/admob.readonly

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

Adapter

תיאור המתאמים שנתמכים על ידי כל מקור מודעות בתהליך בחירת הרשת.

המתאמים תואמים להטמעת SDK ספציפית של מקור המודעות, וכל אחד מהם משויך לפלטפורמה אחת ולרשימה של פורמטים נתמכים של יחידות מודעות. יכול להיות שהמתאמים יחייבו גם לקבוע הגדרות מסוימות כדי לבצע בקשות להצגת מודעות. אפשר לציין תצורות ב-AdUnitMapping על ידי הגדרת צמדי מפתח/ערך של adUnitConfigurations. לדוגמה, אפשר להשתמש ב-adUnitConfigurations כדי להעביר מזהים שונים ל-SDK של צד שלישי של המתאם.

ייצוג JSON 
{
  "name": string,
  "adapterId": string,
  "title": string,
  "platform": string,
  "formats": [
    string
  ],
  "adapterConfigMetadata": [
    {
      object (AdapterConfigMetadata)
    }
  ]
}
שדות
name

string

פלט בלבד. שם המשאב של המתאם. הפורמט הוא:

accounts/{publisherId}/adSources/{adSourceId}/adapters/{adapterId}.
adapterId

string

פלט בלבד. המזהה של המתאם הזה. הוא משמש להגדרת adapterId.
title

string

פלט בלבד. השם המוצג של המתאם הזה.
platform

string

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

הערכים הנתמכים הם: IOS, ANDROIDS, WINDOWS_PHONE
formats[]

string

פלט בלבד. מציין את הפורמטים של יחידות המודעות שנתמכות על ידי המתאם הזה.
adapterConfigMetadata[]

object (AdapterConfigMetadata)

פלט בלבד. המטא-נתונים של ההגדרה שמשויכים למתאם הזה.

AdapterConfigMetadata

המטא-נתונים של ההגדרה שמשויכים למתאם הזה. הן משמשות להגדרת ה-adUnitConfigurations המשויכים ל-AdUnitMappings עבור המתאם הזה.

ייצוג JSON 
{
  "adapterConfigMetadataId": string,
  "adapterConfigMetadataLabel": string,
  "isRequired": boolean
}
שדות
adapterConfigMetadataId

string

הוא משמש למילוי המפתח של adUnitConfigurations.
adapterConfigMetadataLabel

string

שם המטא-נתונים של הגדרת המתאם.
isRequired

boolean

האם המטא-נתונים האלה נחוצים להגדרת AdUnitMappings.