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.

تطبيق

يصِف تطبيق 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_segment} مثال: 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، سيكون رقم تعريفه على App Store. على سبيل المثال: "105169111".

تجدر الإشارة إلى أن إعداد رقم تعريف متجر التطبيقات يُعد إجراءً لا يمكن التراجع عنه. وبعد ربط التطبيق، لا يمكن إلغاء ربطه.
displayName

string

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

AppApprovalState

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

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