Method: accounts.apps.list

تعرض هذه الطريقة التطبيقات ضمن حساب AdMob المحدّد.

طلب HTTP

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

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

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

المعلمات
parent

string

الحقل مطلوب. اسم المورد للحساب الذي سيتم عرض التطبيقات فيه مثال: accounts/pub-9876543210987654

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

المعلمات
pageSize

integer

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

التطبيق

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

تمثيل JSON 
{
  "name": string,
  "appId": string,
  "platform": string,
  "manualAppInfo": {
    object (ManualAppInfo)
  },
  "linkedAppInfo": {
    object (LinkedAppInfo)
  },
  "appApprovalState": enum (AppApprovalState)
}
الحقول
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)

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

يظهر هذا الحقل فقط إذا كان التطبيق مرتبطًا بأحد متاجر التطبيقات.
appApprovalState

enum (AppApprovalState)

النتائج فقط. حالة الموافقة على التطبيق. هذا الحقل للقراءة فقط.

ManualAppInfo

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

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

string

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

LinkedAppInfo

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

تمثيل 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

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

AppApprovalState

حالات الموافقة على تطبيق للأجهزة الجوّالة

عمليات التعداد
APP_APPROVAL_STATE_UNSPECIFIED القيمة التلقائية لحقل لم يتم ضبطه لا تستخدم هذه السمة.
ACTION_REQUIRED يتطلّب التطبيق إجراءً إضافيًا من المستخدم للموافقة عليه. يُرجى الرجوع إلى https://support.google.com/admob/answer/10564477 للاطّلاع على التفاصيل والخطوات التالية.
IN_REVIEW التطبيق في انتظار المراجعة.
APPROVED تمت الموافقة على التطبيق ويمكنه عرض الإعلانات.