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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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

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

الطُرق

get

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