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

فئة التطبيق (على سبيل المثال، ألعاب سباق السرعة أو المحتوى الاجتماعي، أو غير ذلك)

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

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