Method: accounts.adSources.list

إدراج مصادر الإعلانات

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
parent

string

مطلوب. المؤسسة الرئيسية التي تملك هذه المجموعة من مصادر الإعلانات. التنسيق: accounts/{publisherId}

معامِلات طلب البحث

المعلمات
pageSize

integer

الحدّ الأقصى لعدد مصادر الإعلانات المطلوب عرضها. وفي حال عدم تحديد قيمة أو 0، سيتم عرض 10,000 مصدر إعلان كحدّ أقصى. الحد الأقصى للقيمة هو 20000؛ سيتم فرض القيم الأكبر من 10000 على 20000.

pageToken

string

رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق لتطبيق "adSources.list". يمكنك توفير هذا الحقل لاسترداد الصفحة التالية.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

الاستجابة لـ ListAdSourcesRequest.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "adSources": [
    {
      object (AdSource)
    }
  ],
  "nextPageToken": string
}
الحقول
adSources[]

object (AdSource)

مصادر الإعلانات.

nextPageToken

string

يُستخدَم لضبط pageToken في ListAdSourcesRequest لاسترداد الصفحة التالية. في حال إسقاط هذا الحقل، لن تظهر أي صفحات لاحقة.

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

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

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

AdSource

تعريف مصدر إعلان التوسّط

تمثيل JSON
{
  "name": string,
  "adSourceId": string,
  "title": string
}
الحقول
name

string

اسم المورد لمصدر الإعلان هذا.

التنسيق هو: accounts/{publisherId}/adSources/{adSourceId}

adSourceId

string

رقم تعريف مصدر الإعلان هذا.

title

string

الاسم المعروض لمصدر الإعلان هذا.