REST Resource: enterprises.applications

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

معلومات عن تطبيق

تمثيل JSON
{
  "name": string,
  "title": string,
  "permissions": [
    {
      object (ApplicationPermission)
    }
  ],
  "managedProperties": [
    {
      object (ManagedProperty)
    }
  ],
  "iconUrl": string,
  "smallIconUrl": string,
  "appTracks": [
    {
      object (AppTrackInfo)
    }
  ],
  "author": string,
  "playStoreUrl": string,
  "distributionChannel": enum (DistributionChannel),
  "appPricing": enum (AppPricing),
  "description": string,
  "screenshotUrls": [
    string
  ],
  "category": string,
  "recentChanges": string,
  "minAndroidSdkVersion": integer,
  "contentRating": enum (ContentRating),
  "updateTime": string,
  "availableCountries": [
    string
  ],
  "features": [
    enum (AppFeature)
  ],
  "appVersions": [
    {
      object (AppVersion)
    }
  ],
  "fullDescription": string
}
الحقول
name

string

اسم التطبيق بالتنسيق enterprises/{enterprise}/applications/{packageName}

title

string

عنوان التطبيق مترجَم.

permissions[]

object (ApplicationPermission)

الأذونات المطلوبة من التطبيق

managedProperties[]

object (ManagedProperty)

مجموعة المواقع المُدارة المتاحة لضبطها مسبقًا للتطبيق

iconUrl

string

رابط يؤدي إلى صورة يمكن استخدامها كرمز للتطبيق. تكون هذه الصورة مناسبة للاستخدام بحجم يصل إلى 512 × 512 بكسل.

smallIconUrl

string

رابط لصورة أصغر يمكن استخدامها كرمز للتطبيق. تكون هذه الصورة مناسبة للاستخدام حتى حجم 128 × 128 بكسل.

appTracks[]

object (AppTrackInfo)

مسارات التطبيق الظاهرة للمؤسسة

author

string

اسم مؤلف التطبيقات (مثل مطوّر التطبيقات)

playStoreUrl

string

رابط يؤدي إلى صفحة تفاصيل التطبيق (للمستهلك) على Google Play

distributionChannel

enum (DistributionChannel)

كيفية توفّر الحزمة ومستخدميها

appPricing

enum (AppPricing)

ما إذا كان هذا التطبيق مجانيًا أو مجانيًا مع عمليات شراء داخل التطبيق أو مدفوعًا إذا لم يتم تحديد السعر، يعني ذلك أنّ التطبيق لم يعُد متاحًا للجميع (على الرغم من أنّه قد يظل متاحًا للمستخدمين الذين يملكون التطبيق).

description

string

الوصف الترويجي المترجَم، إن توفّر

screenshotUrls[]

string

قائمة بروابط لقطات الشاشة التي تمثّل التطبيق

category

string

فئة التطبيق (مثل RACING أو SOCIAL أو غير ذلك)

recentChanges

string

وصف مترجَم للتغييرات الأخيرة التي تم إجراؤها على التطبيق

minAndroidSdkVersion

integer

الحد الأدنى لحزمة تطوير البرامج (SDK) لنظام التشغيل Android اللازمة لتشغيل التطبيق

contentRating

enum (ContentRating)

تقييم محتوى هذا التطبيق.

updateTime

string (Timestamp format)

النتائج فقط. الوقت التقريبي (خلال 7 أيام) الذي تم فيه نشر التطبيق آخر مرة

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"

availableCountries[]

string

البلدان التي يتوفّر فيها هذا التطبيق وفقًا لمعيار ISO 3166-1 alpha-2

features[]

enum (AppFeature)

الميزات البارزة (إن توفّرت) لهذا التطبيق

appVersions[]

object (AppVersion)

الإصدارات المتوفّرة حاليًا لهذا التطبيق

fullDescription

string

الوصف الكامل للتطبيق، إن توفّر

ApplicationPermission

إذن مطلوب من التطبيق

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

string

سلسلة غير شفافة تُحدِّد الإذن بشكل فريد لم تتم ترجمتها.

name

string

اسم الإذن مترجَم

description

string

وصف أطول للأذونات، يقدّم مزيدًا من التفاصيل حول ما يؤثر فيه مترجَم

ManagedProperty

الموقع المُدار

تمثيل JSON
{
  "key": string,
  "type": enum (ManagedPropertyType),
  "title": string,
  "description": string,
  "entries": [
    {
      object (ManagedPropertyEntry)
    }
  ],
  "defaultValue": value,
  "nestedProperties": [
    {
      object (ManagedProperty)
    }
  ]
}
الحقول
key

string

المفتاح الفريد الذي يستخدمه التطبيق لتحديد الموقع، مثلاً "com.google.android.gm.fieldname".

type

enum (ManagedPropertyType)

نوع الموقع.

title

string

اسم الموقع. مترجَم

description

string

وصف أطول للموقع، يقدّم المزيد من التفاصيل حول ما يؤثر فيه مترجَم

entries[]

object (ManagedPropertyEntry)

بالنسبة إلى السمتَين CHOICE أو MULTISELECT، قائمة الإدخالات المحتمَلة

defaultValue

value (Value format)

القيمة التلقائية للسمة لا تحتوي سمات BUNDLE_ARRAY على قيمة تلقائية.

nestedProperties[]

object (ManagedProperty)

بالنسبة إلى سمات BUNDLE_ARRAY، قائمة السمات المضمّنة يتضمّن موقع BUNDLE_ARRAY مستويَين بحد أقصى.

ManagedPropertyType

نوع الموقع المُدار

عمليات التعداد
MANAGED_PROPERTY_TYPE_UNSPECIFIED لم يتم استخدامها.
BOOL خاصيّة من النوع المنطقي
STRING خاصيّة من نوع سلسلة
INTEGER خاصيّة من نوع عدد صحيح
CHOICE اختيار عنصر واحد من مجموعة
MULTISELECT خيار لعناصر متعددة من مجموعة
HIDDEN قيد مخفيّ لنوع السلسلة (يمكن استخدام القيمة التلقائية لنقل المعلومات التي لا يمكن تعديلها، مثل رمز الإصدار).
BUNDLE حزمة من المواقع
BUNDLE_ARRAY مصفوفة من حِزم المواقع

ManagedPropertyEntry

إدخال موقع مُدار

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

string

القيمة القابلة للقراءة آليًا للعنصر، والتي يجب استخدامها في الإعدادات لم يتمّت ترجمتها.

name

string

اسم القيمة السهل قراءته مترجَم

AppTrackInfo

رقم تعريف لربط اسم قناة إصدار تطبيق.

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

string

معرّف الإصدار الفريد غير القابل للتعديل، والذي يتم الحصول عليه من releaseTrackId في عنوان URL لصفحة Play Console التي تعرض معلومات إصدار التطبيق.

trackAlias

string

اسم المسار المرتبط بالإصدار trackId، والذي تم ضبطه في Play Console ويمكن تعديل الاسم من Play Console.

DistributionChannel

قنوات التوزيع المحتملة

عمليات التعداد
DISTRIBUTION_CHANNEL_UNSPECIFIED غير محدد
PUBLIC_GOOGLE_HOSTED تتوفّر الحزمة من خلال "متجر Play" ولا تقتصر على مؤسسة معيّنة.
PRIVATE_GOOGLE_HOSTED الحزمة هي تطبيق خاص (مخصّص لمؤسسة) ولكن تستضيفه Google.
PRIVATE_SELF_HOSTED تطبيق خاص (مخصّص لمؤسسة) ومُستضاف بشكل خاص

AppPricing

الأسعار المحتملة للتطبيق

عمليات التعداد
APP_PRICING_UNSPECIFIED السعر غير معروف، ويُستخدَم للإشارة إلى تطبيق موافَق عليه غير متاح بشكل عام.
FREE أن يكون التطبيق مجانيًا
FREE_WITH_IN_APP_PURCHASE التطبيق مجاني، ولكنه يتيح إجراء عمليات شراء داخله.
PAID التطبيق مدفوع.

ContentRating

تقييم المحتوى وفقًا لمعيار IARC العام

عمليات التعداد
CONTENT_RATING_UNSPECIFIED غير محدد
THREE_YEARS المحتوى مناسب للأطفال من عمر 3 سنوات وما فوق فقط.
SEVEN_YEARS المحتوى مناسب للأطفال الذين يبلغون 7 سنوات أو أكبر فقط.
TWELVE_YEARS المحتوى مناسب للأشخاص الذين تبلغ أعمارهم 12 عامًا أو أكثر فقط.
SIXTEEN_YEARS المحتوى مناسب للأشخاص الذين يبلغون 16 عامًا أو أكثر فقط.
EIGHTEEN_YEARS محتوى مناسب للأشخاص الذين يبلغون 18 عامًا أو أكثر فقط.

AppFeature

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

عمليات التعداد
APP_FEATURE_UNSPECIFIED غير محدد
VPN_APP التطبيق هو شبكة VPN.

AppVersion

يمثّل هذا الإصدار واحدًا من إصدارات التطبيق.

تمثيل JSON
{
  "versionString": string,
  "versionCode": integer,
  "trackIds": [
    string
  ],
  "production": boolean
}
الحقول
versionString

string

السلسلة التي يستخدمها مطوّر التطبيق في "متجر Play" لتحديد الإصدار ولا يجب أن تكون السلسلة فريدة أو مترجَمة (على سبيل المثال، يمكن أن تكون السلسلة "1.4").

versionCode

integer

معرّف فريد متزايد لإصدار التطبيق

trackIds[]

string

تتبُّع المعرّفات التي تم نشر إصدار التطبيق فيها ولا يشمل ذلك قناة الإصدار العلني (اطّلِع على الإصدار العلني بدلاً من ذلك).

production

boolean

إذا كانت القيمة True، يعني ذلك أنّ هذا الإصدار مخصّص للإصدار العلني.

الطُرق

get

الحصول على معلومات عن تطبيق