REST Resource: appstorecatalog.recentAppViews

المورد: RecentAppView

بيانات وصفية حول تطبيق تم تحديثه مؤخرًا

تمثيل JSON
{
  "appView": {
    object (CatalogAppView)
  }
}
الحقول
appView

object (CatalogAppView)

تم تعديل طريقة عرض التطبيق مؤخرًا.

CatalogAppView

صورة لتطبيق Google Play ضمن ميزة "تصدير الكتالوج" لمتاجر التطبيقات

تمثيل JSON
{
  "packageName": string,
  "developerDetails": {
    object (DeveloperDetails)
  },
  "appContactInformation": {
    object (AppContactInformation)
  },
  "appCategory": enum (AppCategory),
  "appSubcategory": string,
  "hasInAppPurchases": boolean,
  "localizedStoreListings": {
    object (LocalizedStoreListings)
  },
  "deviceCompatibilityRequirements": [
    {
      object (DeviceCompatibilityRequirements)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "permissionsSdk23": [
    {
      object (Permission)
    }
  ],
  "excludedDevicesByIdentifier": [
    {
      object (DeviceIdentifier)
    }
  ],
  "excludedDevicesBySelector": [
    {
      object (DeviceSelector)
    }
  ],
  "activeVersionNames": [
    string
  ],
  "privacyPolicyUrl": string,
  "hasInAppAds": boolean,
  "isAdultOnlyAudience": boolean,
  "iarcCertificateId": string,
  "firstReleaseDate": {
    object (Date)
  },
  "priceInTheUnitedStates": {
    object (Money)
  },
  "salePriceInTheUnitedStates": {
    object (Money)
  },
  "deliveryToken": string,
  "lastPublishTime": string
}
الحقول
packageName

string

اسم حزمة التطبيق

developerDetails

object (DeveloperDetails)

تفاصيل مطوّر التطبيق

appContactInformation

object (AppContactInformation)

معلومات الاتصال التي يوفّرها المطوّر للتطبيق

appCategory

enum (AppCategory)

appSubcategory

string

الفئة الفرعية للتطبيق، مثل "GAME_ACTION"

hasInAppPurchases

boolean

ما إذا كان التطبيق يتضمّن عمليات شراء داخل التطبيق من خلال Google Play

localizedStoreListings

object (LocalizedStoreListings)

بطاقات بيانات المتجر المترجَمة للتطبيق والتي تظهر على Google Play

deviceCompatibilityRequirements[]

object (DeviceCompatibilityRequirements)

قد يحدّد التطبيق مجموعات متعدّدة من متطلبات توافق الجهاز، ويُعتبر الجهاز متوافقًا مع التطبيق إذا كان يستوفي شرطًا واحدًا على الأقل من DeviceCompatibilityRequirements.

permissions[]

object (Permission)

الأذونات المطلوبة التي يصرّح بها التطبيق والتي تنطبق على جميع إصدارات حِزم تطوير البرامج (SDK) لنظام التشغيل Android.

permissionsSdk23[]

object (Permission)

بيان الأذونات المطلوب من التطبيق والذي ينطبق على الإصدار 23 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android والإصدارات الأحدث.

excludedDevicesByIdentifier[]

object (DeviceIdentifier)

قائمة بالأجهزة المستبعَدة من توزيع التطبيق حتى إذا كانت متوافقة مع المتطلبات من deviceCompatibilityRequirements. يتم استخدام عامل التشغيل OR، أي يتم استبعاد الجهاز إذا كان يتطابق مع أي من المعرّفات.

excludedDevicesBySelector[]

object (DeviceSelector)

قائمة بالأجهزة المستبعَدة من توزيع التطبيق حتى إذا كانت متوافقة مع المتطلبات من deviceCompatibilityRequirements. يتم استبعاد الجهاز إذا كان يتطابق مع أي من أدوات الاختيار المحدّدة.

activeVersionNames[]

string

الإصدارات النشطة من التطبيق التي تم ربطها من سمات بيان android:versionName

privacyPolicyUrl

string

عنوان URL لسياسة خصوصية التطبيق

hasInAppAds

boolean

ما إذا كان التطبيق يحتوي على إعلانات

isAdultOnlyAudience

boolean

لتحديد ما إذا كان التطبيق يستهدف جمهورًا من البالغين فقط (أكبر من 18 عامًا).

iarcCertificateId

string

رقم تعريف شهادة IARC للتطبيق

firstReleaseDate

object (Date)

تاريخ إصدار التطبيق لأول مرة

priceInTheUnitedStates

object (Money)

سعر التطبيق في الولايات المتحدة ويكون هذا الحقل فارغًا إذا كان التطبيق مجانيًا.

salePriceInTheUnitedStates

object (Money)

السعر المخفَّض للتطبيق في الولايات المتحدة لا تتم تعبئة هذا الحقل إلا للتطبيقات المدفوعة التي تتضمّن تخفيضات نشطة في الولايات المتحدة.

deliveryToken

string

الرمز المميّز المستخدَم لتسليم التطبيق من خلال واجهة Google Play Inline Install API ويكون الرمز المميّز فريدًا لكل تطبيق على Google Play وكل مجموعة من متاجر التطبيقات الخارجية، وله مدة صلاحية محدودة تبلغ 7 أيام.

lastPublishTime

string (Timestamp format)

الطابع الزمني لآخر مرة تم فيها نشر التطبيق

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30"

DeveloperDetails

تفاصيل مطوّر تطبيق Google Play

تمثيل JSON
{
  "developerName": string,
  "contactEmail": string,
  "address": string,
  "phoneNumber": string,
  "website": string
}
الحقول
developerName

string

اسم مطوّر التطبيق

contactEmail

string

عنوان البريد الإلكتروني الخاص بالمطوّر

address

string

العنوان الجغرافي للمطوّر

phoneNumber

string

رقم هاتف المطوّر

website

string

الموقع الإلكتروني للمطوّر

AppContactInformation

معلومات الاتصال الخاصة بالتطبيق

تمثيل JSON
{
  "contactEmail": string,
  "phoneNumber": string,
  "websiteUrl": string
}
الحقول
contactEmail

string

عنوان البريد الإلكتروني المخصّص للتواصل مع مطوّر هذا التطبيق، ويتم ضبطه دائمًا.

phoneNumber

string

رقم الهاتف المخصّص للتواصل مع مطوّر هذا التطبيق، ويقدّمه المطوّر اختياريًا.

websiteUrl

string

عنوان URL للموقع الإلكتروني المخصّص للتواصل بشأن هذا التطبيق، ويقدّمه المطوّر اختياريًا.

AppCategory

فئة التطبيق

عمليات التعداد
APP_CATEGORY_UNSPECIFIED
GAME
APP

LocalizedStoreListings

تمثيل JSON
{
  "localizedStoreListings": [
    {
      object (LocalizedStoreListing)
    }
  ],
  "defaultLanguageCode": string
}
الحقول
localizedStoreListings[]

object (LocalizedStoreListing)

defaultLanguageCode

string

رمز اللغة التلقائية للتطبيق. إذا لم تتوفّر بطاقة بيانات متجر مترجَمة للغة معيّنة، يتم استخدام مواد العرض من اللغة التلقائية بدلاً من ذلك.

LocalizedStoreListing

بطاقات بيانات المتجر المترجَمة للتطبيق

تمثيل JSON
{
  "languageCode": string,
  "appName": string,
  "shortDescription": string,
  "fullDescription": string,
  "icon": {
    object (ImageAsset)
  },
  "featureGraphic": {
    object (ImageAsset)
  },
  "video": {
    object (VideoAsset)
  },
  "phoneScreenshots": {
    object (ScreenshotSet)
  },
  "tabletSmallScreenshots": {
    object (ScreenshotSet)
  },
  "tabletRegularScreenshots": {
    object (ScreenshotSet)
  }
}
الحقول
languageCode

string

تمثّل هذه السمة رمز اللغة BCP-47 لعملية الأقلمة هذه.

appName

string

اسم التطبيق في هذه اللغة

shortDescription

string

وصف موجز للتطبيق بهذه اللغة

fullDescription

string

وصف أطول للتطبيق بهذه اللغة

icon

object (ImageAsset)

رمز التطبيق

featureGraphic

object (ImageAsset)

الرسم المميّز للتطبيق

video

object (VideoAsset)

فيديو التطبيق

phoneScreenshots

object (ScreenshotSet)

لقطات شاشة التطبيق على الهاتف

tabletSmallScreenshots

object (ScreenshotSet)

لقطات شاشة التطبيق على الأجهزة اللوحية الصغيرة

tabletRegularScreenshots

object (ScreenshotSet)

لقطات الشاشة العادية للتطبيق على الأجهزة اللوحية

ImageAsset

مادة عرض صورة

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

string

عنوان URL لمادة عرض الصورة

VideoAsset

مادة عرض فيديو

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

string

عنوان URL لمادة عرض الفيديو

ScreenshotSet

مجموعة من لقطات الشاشة

تمثيل JSON
{
  "screenshots": [
    {
      object (ImageAsset)
    }
  ]
}
الحقول
screenshots[]

object (ImageAsset)

مواد عرض الصور الخاصة بلقطات الشاشة

DeviceCompatibilityRequirements

يحدّد هذا العنصر مجموعة من متطلبات توافق الجهاز مع التطبيق. يجب أن يستوفي الجهاز جميع المتطلبات في المجموعة ليُعتبر متوافقًا مع التطبيق.

تمثيل JSON
{
  "sdkVersion": {
    object (SdkVersion)
  },
  "requiredSystemFeatures": [
    string
  ],
  "requiredSoftwareLibraries": [
    string
  ],
  "isScreenRequired": boolean,
  "glEsVersion": integer,
  "usesConfigurations": [
    {
      object (UsesConfiguration)
    }
  ],
  "compatibleScreens": [
    {
      object (CompatibleScreen)
    }
  ],
  "supportedScreens": [
    enum (ScreenSize)
  ],
  "requiresSmallestWidthDp": string,
  "supportedGlTextures": [
    string
  ],
  "nativePlatforms": [
    string
  ],
  "use32BitAbi": enum (Use32BitAbi)
}
الحقول
sdkVersion

object (SdkVersion)

تحدِّد هذه السمة نطاقًا لإصدارات حزمة SDK المتوافقة مع التطبيق.

requiredSystemFeatures[]

string

ميزات النظام التي يتطلبها التطبيق يجب أن يتضمّن الجهاز جميع ميزات النظام ليُعتبر متوافقًا مع التطبيق.

requiredSoftwareLibraries[]

string

قائمة بالمكتبات المطلوبة كما هو موضّح في علامة البيان uses-library.

isScreenRequired

boolean

يحدّد ما إذا كان التطبيق يتطلّب شاشة.

glEsVersion

integer

إصدار OpenGL ES المطلوب

usesConfigurations[]

object (UsesConfiguration)

تعرض هذه القائمة جميع الإعدادات التي تم وضع علامة عليها على أنّها مطلوبة باستخدام علامة البيان uses-configuration. يمثّل كل مثيل من هذا النموذج الأوّلي إدخالاً واحدًا في uses-configuration. يُرجى الاطّلاع على http://developer.android.com/guide/topics/manifest/uses-configuration-element.html

compatibleScreens[]

object (CompatibleScreen)

الشاشات المتوافقة كما هو موضّح في علامة بيان compatible-screens.

supportedScreens[]

enum (ScreenSize)

الشاشات المتوافقة كما هو موضّح في علامة بيان supports-screens.

requiresSmallestWidthDp

string (int64 format)

تحدّد هذه السمة الحد الأدنى لأصغر عرض مطلوب للشاشة.

supportedGlTextures[]

string

بُنى gl المتوافقة كما هو محدّد في علامة بيان supported-gl-texture

nativePlatforms[]

string

قائمة بواجهات التطبيقات الثنائية (ABI) المطلوبة، مثل armeabi أو x86

use32BitAbi

enum (Use32BitAbi)

تم استرداد قيمة علامة android:use32BitAbi من ملف البيان.

SdkVersion

يحدّد هذا الإعداد نطاقًا لإصدارات حزمة تطوير البرامج (SDK). يُعدّ الجهاز متوافقًا إذا كان إصدار حزمة تطوير البرامج (SDK) يقع ضمن نطاق minSdkVersion وmaxSdkVersion.

تمثيل JSON
{
  "minSdkVersion": string,
  "maxSdkVersion": string,
  "targetSdkVersion": string
}
الحقول
minSdkVersion

string (int64 format)

الحد الأدنى لإصدار حزمة تطوير البرامج (SDK) المطلوب للتطبيق (شامل).

maxSdkVersion

string (int64 format)

الحد الأقصى لإصدار حزمة تطوير البرامج (SDK) المطلوب للتطبيق (شامل).

targetSdkVersion

string (int64 format)

تمثّل هذه السمة إصدار حزمة تطوير البرامج (SDK) المستهدَف للتطبيق.

UsesConfiguration

تمثّل جميع الإعدادات التي تم وضع علامة عليها على أنّها مطلوبة باستخدام علامة البيان uses-configuration.

تمثيل JSON
{
  "requiresFiveWayNavigation": boolean,
  "requiresHardwareKeyboard": boolean,
  "requiredKeyboardType": enum (KeyboardType),
  "requiredNavigationType": enum (NavigationType),
  "requiredTouchscreenType": enum (TouchScreenType)
}
الحقول
requiresFiveWayNavigation

boolean

ما إذا كان التطبيق يتطلّب وحدة تحكُّم للتنقُّل بخمسة اتجاهات أم لا

requiresHardwareKeyboard

boolean

يشير ذلك إلى ما إذا كان التطبيق يتطلّب لوحة مفاتيح خارجية أم لا.

requiredKeyboardType

enum (KeyboardType)

نوع لوحة المفاتيح المطلوبة

requiredNavigationType

enum (NavigationType)

يجب استخدام جهاز تنقّل.

requiredTouchscreenType

enum (TouchScreenType)

نوع شاشة اللمس المطلوبة

KeyboardType

عمليات التعداد
KEYBOARD_TYPE_UNSPECIFIED
KEYBOARD_TYPE_UNDEFINED
KEYBOARD_TYPE_NO_KEYS
KEYBOARD_TYPE_QWERTY
KEYBOARD_TYPE_TWELVE_KEY

TouchScreenType

عمليات التعداد
TOUCHSCREEN_TYPE_UNSPECIFIED
TOUCHSCREEN_TYPE_UNDEFINED
TOUCHSCREEN_TYPE_NO_TOUCHSCREEN
TOUCHSCREEN_TYPE_STYLUS
TOUCHSCREEN_TYPE_FINGER

CompatibleScreen

الشاشات المتوافقة كما هو موضّح في علامة بيان compatible-screens.

تمثيل JSON
{
  "screenSize": enum (ScreenSize),
  "density": enum (Density)
}
الحقول
screenSize

enum (ScreenSize)

حجم الشاشة

density

enum (Density)

كثافة الشاشة

ScreenSize

حجم الشاشة

عمليات التعداد
SCREEN_SIZE_UNSPECIFIED
SCREEN_SIZE_SMALL
SCREEN_SIZE_NORMAL
SCREEN_SIZE_LARGE
SCREEN_SIZE_EXTRA_LARGE

الكثافة

كثافة الشاشة

عمليات التعداد
DENSITY_UNSPECIFIED
DENSITY_NODPI
DENSITY_LDPI
DENSITY_MDPI
DENSITY_TVDPI
DENSITY_HDPI
DENSITY_280
DENSITY_XHDPI
DENSITY_360
DENSITY_400
DENSITY_420
DENSITY_XXHDPI
DENSITY_560
DENSITY_XXXHDPI

Use32BitAbi

قيمة علامة android:use32BitAbi التي تم استردادها من ملف البيان. https://developer.android.com/reference/android/R.attr#use32bitAbi.

عمليات التعداد
USE_32_BIT_ABI_UNSPECIFIED
USE_32_BIT_ABI_TRUE تم ضبط قيمة use32BitAbi على "true".
USE_32_BIT_ABI_OTHER لم يتم ضبط قيمة use32BitAbi أو تم ضبطها على قيمة أخرى غير "صحيح".

الإذن

إذن يعلنه التطبيق

تمثيل JSON
{
  "name": string,
  "maxSdkVersion": integer
}
الحقول
name

string

سمة name التي تشير إلى اسم الإذن

maxSdkVersion

integer

سمة maxSdkVersion التي تشير إلى إصدار حزمة تطوير البرامج (SDK) لنظام التشغيل Android الذي يتم طلب الإذن له.

معرّف الجهاز

يحدّد معرّف جهاز معيّن.

تمثيل JSON
{
  "deviceBrand": string,
  "deviceModel": string
}
الحقول
deviceBrand

string

deviceModel

string

DeviceSelector

تحدّد هذه السمة أداة اختيار الجهاز. يُعدّ الجهاز مطابقًا إذا كان يتطابق مع أي من أدوات الاختيار المحدّدة.

تمثيل JSON
{
  "ramSelector": {
    object (RamSelector)
  },
  "socSelectors": [
    {
      object (SocSelector)
    }
  ],
  "deviceTypeSelector": enum (DeviceTypeSelector)
}
الحقول
ramSelector

object (RamSelector)

تحدِّد هذه السمة أداة اختيار ذاكرة الوصول العشوائي (RAM) لجهاز معيّن.

socSelectors[]

object (SocSelector)

أدوات اختيار SOC يتطابق الجهاز مع أداة اختيار الجهاز إذا كان يتطابق مع أي من أدوات اختيار SOC.

deviceTypeSelector

enum (DeviceTypeSelector)

RamSelector

تحدّد هذه السمة أداة اختيار ذاكرة الوصول العشوائي (RAM) لجهاز معيّن.

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

string (int64 format)

ستطابق هذه السمة أي جهاز يحتوي على ذاكرة وصول عشوائي (RAM) أقل من أو تساوي ramMbLessThanOrEqual ميغابايت.

SocSelector

تحدّد هذه السمة أداة اختيار شريحة النظام (SOC) لجهاز معيّن. سيؤدي ذلك إلى مطابقة أي جهاز تتطابق فيه المنظومة على رقاقة (SoC) مع جميع الحقول في أداة الاختيار.

تمثيل JSON
{
  "socMake": string,
  "socModel": string
}
الحقول
socMake

string

socModel

string

DeviceTypeSelector

أداة اختيار لمطابقة الأجهزة من نوع معيّن

عمليات التعداد
DEVICE_TYPE_SELECTOR_UNSPECIFIED
ANDROID_GO

التاريخ

تمثّل تاريخًا كاملاً أو جزئيًا في التقويم، مثل تاريخ ميلاد. يتم تحديد الوقت والمنطقة الزمنية في مكان آخر أو لا يكونان مهمَّين. التاريخ مرتبط بالتقويم الميلادي. ويمكن أن يمثّل ذلك أحد الخيارات التالية:

  • تاريخ كامل، مع قيم غير صفرية للسنة والشهر واليوم.
  • شهر ويوم، مع سنة صفرية (على سبيل المثال، ذكرى سنوية).
  • سنة بمفردها، مع شهر صفر ويوم صفر.
  • سنة وشهر، مع يوم صفر (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان).

الأنواع ذات الصلة:

تمثيل JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
الحقول
year

integer

تمثّل السنة في التاريخ. يجب أن تتراوح القيمة بين 1 و9999، أو أن تكون 0 لتحديد تاريخ بدون سنة.

month

integer

شهر من السنة يجب أن يتراوح بين 1 و12، أو أن يكون 0 لتحديد سنة بدون شهر ويوم.

day

integer

يوم من الشهر يجب أن تكون القيمة بين 1 و31 وصالحة للسنة والشهر، أو 0 لتحديد سنة بمفردها أو سنة وشهر عندما لا يكون اليوم مهمًا.

الطُرق

get

تعرض هذه الطريقة بيانات وصفية حول تطبيق تم تحديثه مؤخرًا.

رموز الخطأ

تعرض عمليات هذا المورد رموز الخطأ التالية في بروتوكول HTTP:

رمز الخطأ السبب الوصف الدقة