- طلب HTTP
- مَعلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- التطبيق
- ManualAppInfo
- LinkedAppInfo
- AppApprovalState
- أمثلة
- جرِّبه الآن
أدرج التطبيقات ضمن حساب AdMob المحدّد.
طلب HTTP
GET https://admob.googleapis.com/v1/{parent=accounts/*}/apps
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
parent |
مطلوبة. اسم مورد الحساب المطلوب إدراج التطبيقات له مثال: accounts/pub-9876543210987654 |
معلمات طلب البحث
المَعلمات | |
---|---|
pageSize |
الحد الأقصى لعدد التطبيقات المطلوب عرضها. إذا لم يتم تحديد ذلك أو إذا كانت القيمة 0، سيتم عرض 10,000 تطبيق على الأكثر. الحد الأقصى للقيمة هو 20,000، وسيتم فرض القيمة التي تزيد عن 20,000 لتصبح 20,000. |
pageToken |
تشير القيمة التي تعرضها آخر |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
الرد على طلب قائمة التطبيقات.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"apps": [
{
object ( |
الحقول | |
---|---|
apps[] |
التطبيقات الناتجة للحساب المطلوب. |
nextPageToken |
إذا لم يكن الحقل فارغًا، يشير ذلك إلى احتمال وجود المزيد من التطبيقات في الطلب، ويجب تمرير هذه القيمة في سمة |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/admob.readonly
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
تطبيق
يصِف تطبيق AdMob لنظام أساسي معيّن (على سبيل المثال: Android أو iOS).
تمثيل JSON |
---|
{ "name": string, "appId": string, "platform": string, "manualAppInfo": { object ( |
الحقول | |
---|---|
name |
اسم المورد لهذا التطبيق. التنسيق هو accounts/{publisherId}/apps/{app_id_segment} مثال: accounts/pub-9876543210987654/apps/0123456789 |
appId |
رقم التعريف المرئي خارجيًا للتطبيق والذي يمكن استخدامه للدمج مع حزمة تطوير البرامج (SDK) في AdMob. هذه خاصية للقراءة فقط. مثال: ca-app-pub-9876543210987654~0123456789 |
platform |
يصِف النظام الأساسي للتطبيق. يقتصر على "IOS" و "ANDROID". |
manualAppInfo |
معلومات تطبيق غير مرتبط بأي متجر تطبيقات. وبعد ربط التطبيق، ستظل هذه المعلومات قابلة للاسترداد. إذا لم يتم تقديم اسم للتطبيق عند إنشائه، سيتم استخدام اسم عنصر نائب. |
linkedAppInfo |
غير قابل للتغيير. معلومات تطبيق مرتبط بمتجر تطبيقات. ولا يتوفّر هذا الحقل إلا إذا كان التطبيق مرتبطًا بمتجر تطبيقات. |
appApprovalState |
النتائج فقط. حالة الموافقة على التطبيق: هذا الحقل للقراءة فقط. |
ManualAppInfo
المعلومات المقدّمة للتطبيقات اليدوية التي ليست مرتبطة بمتجر تطبيقات (مثل: Google Play أو App Store)
تمثيل JSON |
---|
{ "displayName": string } |
الحقول | |
---|---|
displayName |
الاسم المعروض للتطبيق كما هو موضّح في واجهة مستخدم AdMob، والذي يقدّمه المستخدم. الحد الأقصى للطول المسموح به هو 80 حرفًا. |
LinkedAppInfo
معلومات من متجر التطبيقات إذا كان التطبيق مرتبطًا بمتجر التطبيقات.
تمثيل JSON |
---|
{ "appStoreId": string, "displayName": string } |
الحقول | |
---|---|
appStoreId |
رقم تعريف التطبيق في متجر التطبيقات، ولا يظهر إلّا إذا كان التطبيق مرتبطًا بمتجر التطبيقات. في حال إضافة التطبيق إلى "متجر Google Play"، سيكون معرّف التطبيق. على سبيل المثال: "com.example.myapp". لمعرفة مزيد من المعلومات، يمكنك الانتقال إلى https://developer.android.com/studio/build/application-id. وفي حال إضافة التطبيق إلى Apple App Store، سيكون رقم تعريفه على App Store. على سبيل المثال: "105169111". تجدر الإشارة إلى أن إعداد رقم تعريف متجر التطبيقات يُعد إجراءً لا يمكن التراجع عنه. وبعد ربط التطبيق، لا يمكن إلغاء ربطه. |
displayName |
النتائج فقط. عرض اسم التطبيق كما يظهر في متجر التطبيقات. هذا حقل للمخرجات فقط، وقد يكون فارغًا إذا تعذّر العثور على التطبيق في المتجر. |
AppApprovalState
تنص حالة الموافقة على التطبيق المتوافق مع الأجهزة الجوّالة.
عمليات التعداد | |
---|---|
APP_APPROVAL_STATE_UNSPECIFIED |
القيمة التلقائية لحقل لم يتم تحديده. يُرجى عدم الاستخدام. |
ACTION_REQUIRED |
يتطلب التطبيق الموافقة على إجراء إضافي من المستخدم. يُرجى الرجوع إلى https://support.google.com/admob/answer/10564477 لمزيد من التفاصيل والخطوات التالية. |
IN_REVIEW |
التطبيق في انتظار المراجعة. |
APPROVED |
تمت الموافقة على التطبيق ويمكنه عرض الإعلانات. |