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 Overview.

مُنسّق

توضّح هذه السمة برامج التكييف المتوافقة مع كل مصدر إعلان للتوسّط.

تتطابق المحوّلات مع عملية تنفيذ محدّدة لحزمة تطوير البرامج (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 وANDROID و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