- طلب HTTP
- مَعلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- المحوِّل
- AdapterConfigMetadata
- أمثلة
- جرِّبه الآن
أدرِج محوّلات مصدر الإعلان.
طلب HTTP
GET https://admob.googleapis.com/v1beta/{parent=accounts/*/adSources/*}/adapters
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
parent |
مطلوبة. الحساب الرئيسي الذي يملك هذه المجموعة من المحوّلات التنسيق: accounts/{publisherId}/adSources/{adSourceId} |
معلمات طلب البحث
المَعلمات | |
---|---|
pageSize |
الحد الأقصى لعدد المحوّلات المطلوب إرجاعها إذا لم يتم تحديد ذلك أو إذا كانت القيمة 0، سيتم إرجاع 10,000 محوّل على الأكثر. الحد الأقصى للقيمة هو 20,000، وسيتم فرض القيمة التي تزيد عن 20,000 لتصبح 20,000. |
pageToken |
رمز مميّز للصفحة تم تلقّيه من مكالمة سابقة لـ |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
الرد على ListAdaptersRequest.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"adapters": [
{
object ( |
الحقول | |
---|---|
adapters[] |
المحوّل. |
nextPageToken |
يُستخدم لضبط |
نطاقات التفويض
يتطلب استخدام أحد نطاقات 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 ( |
الحقول | |
---|---|
name |
النتائج فقط. اسم مورد المحوّل. التنسيق هو: accounts/{publisherId}/adSources/{adSourceId}/adapters/{adapterId}. |
adapterId |
النتائج فقط. رقم تعريف هذا المحوّل. وتُستخدَم لضبط adapterId. |
title |
النتائج فقط. الاسم المعروض لهذا المحوّل. |
platform |
النتائج فقط. النظام الأساسي للتطبيق المتوافق مع الأجهزة الجوّالة متوافق مع هذا المحوّل. القيم المسموح بها هي: IOS وANDROID وWINDOWS_PHONE. |
formats[] |
النتائج فقط. تشير إلى تنسيقات الوحدات الإعلانية التي يدعمها هذا المحوّل. |
adapterConfigMetadata[] |
النتائج فقط. البيانات الوصفية للإعدادات المرتبطة بهذا المحوِّل. |
AdapterConfigMetadata
البيانات الوصفية للإعدادات المرتبطة بهذا المحوِّل. وتُستخدَم لتحديد إعدادات adUnitConfigurations المرتبطة بـ AdUnitMappings لهذا المحوِّل.
تمثيل JSON |
---|
{ "adapterConfigMetadataId": string, "adapterConfigMetadataLabel": string, "isRequired": boolean } |
الحقول | |
---|---|
adapterConfigMetadataId |
وتُستخدم هذه البيانات لملء مفتاح adUnitConfigurations. |
adapterConfigMetadataLabel |
اسم البيانات الوصفية لإعدادات المحوِّل. |
isRequired |
ما إذا كانت البيانات الوصفية هذه مطلوبة لإعداد AdUnitMappings. |