Method: accounts.apps.list

أدرِج التطبيقات ضمن حساب AdMob المحدّد.

طلب HTTP

GET https://admob.googleapis.com/v1/{parent=accounts/*}/apps

يستخدم عنوان URL بنية gRPC TransEncoding.

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

المعلَمات
parent

string

مطلوب. اسم المورد للحساب المطلوب إدراج التطبيقات له. مثال: accounts/pub-9876543210987654

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

المعلَمات
pageSize

integer

الحد الأقصى لعدد التطبيقات المطلوب عرضها. وإذا لم يتم تحديدها أو كانت صفرًا، سيتم عرض 10,000 تطبيق كحد أقصى. الحد الأقصى للقيمة هو 20,000. سيتم فرض القيم التي تزيد عن 20,000 على 20,000.

pageToken

string

تشير القيمة التي تعرضها آخر ListAppsResponse إلى أنّ هذه النتيجة استمرار لاستدعاء apps.list سابق، وأنّ النظام يجب أن يعرض الصفحة التالية من البيانات.

نص الطلب

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

نص الاستجابة

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

الاستجابة لطلب قائمة التطبيقات.

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

object (App)

التطبيقات الناتجة للحساب المطلوب.

nextPageToken

string

إذا لم تكن فارغة، تشير هذه القيمة إلى أنه قد يكون هناك المزيد من التطبيقات للطلب؛ حيث يجب تمرير هذه القيمة في ListAppsRequest جديد.

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

يجب توفير نطاق OAuth التالي:

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

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

التطبيق

يصف تطبيق AdMob لنظام أساسي معيّن (مثل Android أو iOS).

تمثيل JSON
{
  "name": string,
  "appId": string,
  "platform": string,
  "manualAppInfo": {
    object (ManualAppInfo)
  },
  "linkedAppInfo": {
    object (LinkedAppInfo)
  }
}
الحقول
name

string

اسم المورد لهذا التطبيق. التنسيق هو accounts/{publisherId}/apps/{app_id_fragment} مثال: accounts/pub-9876543210987654/apps/0123456789

appId

string

المعرّف المرئي خارجيًا للتطبيق والذي يمكن استخدامه للدمج مع حزمة تطوير البرامج (SDK) في AdMob. هذه الخاصية للقراءة فقط. مثال: ca-app-pub-9876543210987654~ 0123456789

platform

string

يصف النظام الأساسي للتطبيق. ويقتصر على "IOS" و "ANDROID".

manualAppInfo

object (ManualAppInfo)

معلومات تطبيق غير مرتبط بأي متجر تطبيقات.

بعد ربط أحد التطبيقات، ستظل هذه المعلومات قابلة للاسترداد. إذا لم يتم توفير اسم للتطبيق عند الإنشاء، سيتم استخدام اسم عنصر نائب.

linkedAppInfo

object (LinkedAppInfo)

غير ثابت. معلومات أحد التطبيقات المرتبطة بمتجر التطبيقات.

ويتوفّر هذا الحقل في حال كان التطبيق مرتبطًا بمتجر التطبيقات فقط.

معلومات التطبيق اليدوية

معلومات مقدَّمة للتطبيقات اليدوية التي لم يتم ربطها بمتجر تطبيقات (مثال: Google Play أو App Store).

تمثيل JSON
{
  "displayName": string
}
الحقول
displayName

string

هو الاسم المعروض للتطبيق كما هو موضّح في واجهة مستخدم AdMob، والذي يقدمه المستخدم. الحد الأقصى المسموح به للطول هو 80 حرفًا.

معلومات LinkedApp

معلومات من متجر التطبيقات إذا كان التطبيق مرتبطًا بمتجر التطبيقات.

تمثيل JSON
{
  "appStoreId": string,
  "displayName": string
}
الحقول
appStoreId

string

رقم تعريف متجر التطبيقات للتطبيق، ويمكنك تقديمه إذا كان التطبيق مرتبطًا بمتجر تطبيقات فقط.

وإذا تمت إضافة التطبيق إلى متجر Google Play، سيكون معرّف التطبيق. على سبيل المثال: "com.example.myapp". انتقِل إلى https://developer.android.com/studio/build/application-id.

في حال إضافة التطبيق إلى Apple App Store، سيكون هو رقم تعريف متجر التطبيقات. على سبيل المثال: "105169111".

يُرجى ملاحظة أن ضبط معرّف متجر التطبيقات يُعتبر إجراءً لا يمكن التراجع عنه. بعد ربط التطبيق، لا يمكن إلغاء ربطه.

displayName

string

إخراج فقط. الاسم المعروض للتطبيق كما يظهر في متجر التطبيقات. هذا الحقل للإخراج فقط، وقد يكون فارغًا إذا تعذر العثور على التطبيق في المتجر.