REST Resource: accounts.apps

المرجع: تطبيق

يصِف تطبيق 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,
  "androidAppStores": [
    enum (AndroidAppStore)
  ]
}
الحقول
appStoreId

string

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

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

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

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

string

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

enum (AndroidAppStore)

اختياريّ. معلومات متجر التطبيقات لتطبيقات Android المنشورة. يُستخدم هذا الحقل فقط للتطبيقات على نظام Android الأساسي، وسيتم تجاهله إذا تم ضبط PLATFORM على iOS. ستكون القيمة التلقائية هي متجر تطبيقات Google Play. يمكن تعديل هذا الحقل بعد إنشاء التطبيق. إذا لم يتم نشر التطبيق، لن يتم تضمين هذا الحقل في الرد.

AndroidAppStore

متاجر تطبيقات Android

عمليات التعداد
ANDROID_APP_STORE_UNSPECIFIED القيمة التلقائية لحقل لم يتم تحديده. يُرجى عدم الاستخدام.
GOOGLE_PLAY_APP_STORE "متجر Google Play".
AMAZON_APP_STORE متجر تطبيقات Amazon.
OPPO_APP_STORE Oppo App Market.
SAMSUNG_APP_STORE متجر Samsung Galaxy.
VIVO_APP_STORE متجر تطبيقات VIVO.
XIAOMI_APP_STORE الحصول على تطبيقات Xiaomi

AppApprovalState

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

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

الطُرق

create

 ينشئ تطبيقًا ضمن حساب AdMob المحدّد.

list

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