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 تطبيق كحدّ أقصى. الحد الأقصى للقيمة هو 20000؛ سيتم فرض القيم الأكبر من 20000 على 20000.
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، سيكون رقم تعريف متجر التطبيقات. على سبيل المثال، "105169111".

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

string

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

AppApprovalState

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

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