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.

مُنسّق

يصف المحوِّلات المتوافقة مع كل مصدر إعلان توسّط.

تتوافق المحوِّلات مع عملية تنفيذ معيّنة لحزمة تطوير البرامج (SDK) لمصدر الإعلان، ويتم ربط كل محوِّلات بمنصّة واحدة وقائمة بأشكال الوحدات الإعلانية المتوافقة. وقد تتطلب المحوّلات أيضًا ضبط بعض الإعدادات لتنفيذ طلبات الإعلان. يمكن تحديد الإعدادات في AdUnitMappings عن طريق ضبط أزواج المفتاح/القيمة 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.