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 أو اجتماعي أو غير ذلك)
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

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