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 محوّل كحدّ أقصى. الحد الأقصى للقيمة هو 20000؛ سيتم فرض القيم الأكبر من 20000 على 20000.
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) لمصدر الإعلان، وترتبط كلّ منها بمنصّة واحدة وقائمة بتنسيقات الوحدات الإعلانية المتوافقة. قد تتطلب المحوّلات أيضًا إعداد بعض الإعدادات لتنفيذ طلبات الإعلان. يمكن تحديد الإعدادات في 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