REST Resource: customers.apps.android

المورد: AppDetails

مرجع يمثّل تفاصيل التطبيق

تمثيل JSON 
{
  "name": string,
  "displayName": string,
  "description": string,
  "appId": string,
  "revisionId": string,
  "type": enum (AppItemType),
  "iconUri": string,
  "detailUri": string,
  "firstPublishTime": string,
  "latestPublishTime": string,
  "publisher": string,
  "isPaidApp": boolean,
  "homepageUri": string,
  "privacyPolicyUri": string,
  "reviewNumber": string,
  "reviewRating": number,
  "serviceError": {
    object (Status)
  },
  "categoryIds": [
    string
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "chromeAppInfo": {
    object (ChromeAppInfo)
  },
  "androidAppInfo": {
    object (AndroidAppInfo)
  }
  // End of mutually exclusive fields.
}
الحقول
name

string

النتائج فقط. التنسيق: name=customers/{customerId}/apps/{chrome|android|web}/{appId}@{version}
displayName

string

النتائج فقط. الاسم المعروض للتطبيق
description

string

النتائج فقط. وصف التطبيق
appId

string

النتائج فقط. المعرّف الفريد للمتجر الذي يبيع السلعة أمثلة: "gmbmikajjgmnabiglmofipeabaddhgne" لإضافة Chrome "حفظ في Google Drive"، و"com.google.android.apps.docs" لتطبيق Google Drive المتوافق مع Android.
revisionId

string

النتائج فقط. إصدار التطبيق يتم تنفيذ مراجعة جديدة كلما تم نشر إصدار جديد من التطبيق.
type

enum (AppItemType)

النتائج فقط. نوع التطبيق
iconUri

string

النتائج فقط. رابط ينقل إلى صورة يمكن استخدامها كرمز للمنتج
detailUri

string

النتائج فقط. تمثّل هذه السمة معرّف الموارد المنتظم (URI) لصفحة تفاصيل العنصر.
firstPublishTime

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"
latestPublishTime

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"
publisher

string

النتائج فقط. ناشر السلعة
isPaidApp

boolean

النتائج فقط. يشير إلى ما إذا كان التطبيق مدفوعًا أو يتضمّن محتوًى مدفوعًا.
homepageUri

string

النتائج فقط. الصفحة الرئيسية أو معرّف الموارد المنتظم (URI) للموقع الإلكتروني
privacyPolicyUri

string

النتائج فقط. معرّف الموارد المنتظم (URI) الذي يشير إلى سياسة الخصوصية في التطبيق، إذا قدّمه المطوّر. حقل خاص بالإصدار يتم ضبطه فقط عند العثور على إصدار التطبيق المطلوب.
reviewNumber

string (int64 format)

النتائج فقط. عدد المراجعات التي تم تلقّيها ستكون معلومات مراجعة "سوق Chrome الإلكتروني" دائمًا لأحدث إصدار من التطبيق.
reviewRating

number

النتائج فقط. تقييم التطبيق (من 5 نجوم) ستكون معلومات مراجعة "سوق Chrome الإلكتروني" دائمًا لأحدث إصدار من التطبيق.
serviceError

object (Status)

النتائج فقط. معلومات عن خطأ جزئي في الخدمة، إن وُجد
categoryIds[]

string

النتائج فقط. أرقام تعريف فئات التطبيق، وهي نفسها الأرقام المخزّنة في عنصر "السوق الإلكتروني". من المتوقّع أن يكون هناك معرّف فئة واحد فقط.
في ما يلي قائمة بالحقول التي يستبعد بعضها بعضًا. سيتم ضبط حقل واحد على الأكثر في الرد:
chromeAppInfo

object (ChromeAppInfo)

النتائج فقط. معلومات تطبيق "سوق Chrome الإلكتروني"
androidAppInfo

object (AndroidAppInfo)

النتائج فقط. معلومات تطبيق Android
نهاية الحقول التي يستبعد كلّ منها الآخر

AppItemType

نوع التطبيق

عمليات التعداد
APP_ITEM_TYPE_UNSPECIFIED نوع التطبيق غير محدّد.
CHROME تطبيق Chrome
ANDROID تطبيق ARC++‎
WEB تطبيق الويب

ChromeAppInfo

معلومات تطبيق "سوق Chrome الإلكتروني"

تمثيل JSON 
{
  "minUserCount": integer,
  "permissions": [
    {
      object (ChromeAppPermission)
    }
  ],
  "siteAccess": [
    {
      object (ChromeAppSiteAccess)
    }
  ],
  "type": enum (ItemType),
  "riskAssessment": {
    object (RiskAssessmentData)
  },
  "supportEnabled": boolean,
  "isTheme": boolean,
  "googleOwned": boolean,
  "isCwsHosted": boolean,
  "kioskEnabled": boolean,
  "isKioskOnly": boolean,
  "isExtensionPolicySupported": boolean,
  "manifestVersion": string
}
الحقول
minUserCount

integer

النتائج فقط. الحد الأدنى لعدد المستخدمين الذين يستخدمون هذا التطبيق
permissions[]

object (ChromeAppPermission)

النتائج فقط. كل إذن مخصّص يطلبه التطبيق، وهو حقل خاص بالإصدار يتم ضبطه فقط عند العثور على إصدار التطبيق المطلوب.
siteAccess[]

object (ChromeAppSiteAccess)

النتائج فقط. كل إذن يمنح إمكانية الوصول إلى النطاقات أو أنماط المضيف الواسعة النطاق ( مثلاً: www.google.com). ويشمل ذلك التطابقات من النصوص البرمجية للمحتوى بالإضافة إلى المضيفين في عقدة الأذونات في البيان. حقل خاص بالإصدار يتم ضبطه فقط عند العثور على إصدار التطبيق المطلوب.
type

enum (ItemType)

النتائج فقط. أنواع العناصر في "سوق Chrome الإلكتروني"
riskAssessment

object (RiskAssessmentData)

النتائج فقط. يحتوي على بيانات تقييم المخاطر لإضافة Chrome.
supportEnabled

boolean

النتائج فقط. أتاح مطوّر التطبيق الدعم لتطبيقه. وهو حقل خاص بالإصدار يتم ضبطه فقط عند العثور على إصدار التطبيق المطلوب.
isTheme

boolean

النتائج فقط. ما إذا كان التطبيق أو الإضافة مظهرًا
googleOwned

boolean

النتائج فقط. ما إذا كان التطبيق أو الإضافة من إنشاء Google وصيانتها حقل خاص بالإصدار يتم ضبطه فقط عند العثور على إصدار التطبيق المطلوب.
isCwsHosted

boolean

النتائج فقط. ما إذا كان التطبيق أو الإضافة في حالة منشورة في "سوق Chrome الإلكتروني".
kioskEnabled

boolean

النتائج فقط. ما إذا كان هذا التطبيق مفعَّلاً في "وضع Kiosk" على أجهزة ChromeOS
isKioskOnly

boolean

النتائج فقط. ما إذا كان التطبيق مخصّصًا لوضع Kiosk فقط على أجهزة ChromeOS
isExtensionPolicySupported

boolean

النتائج فقط. ما إذا كان التطبيق يتوافق مع سياسة الإضافات
manifestVersion

string (int64 format)

النتائج فقط. إصدار ملف بيان هذه الإضافة

ChromeAppPermission

الإذن الذي يطلبه تطبيق أو إضافة Chrome

تمثيل JSON 
{
  "type": string,
  "documentationUri": string,
  "accessUserData": boolean
}
الحقول
type

string

النتائج فقط. نوع الإذن
documentationUri

string

النتائج فقط. معرّف موارد منتظم (URI) لصفحة تحتوي على مستندات للإذن الحالي، إن توفّر
accessUserData

boolean

النتائج فقط. تحدّد هذه السياسة ما إذا كان هذا الإذن يمنح التطبيق أو الإضافة إمكانية الوصول إلى بيانات المستخدم، في حال توفّره.

ChromeAppSiteAccess

تمثّل إذن مضيف واحد.

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

string

النتائج فقط. ويمكن أن يحتوي هذا على مضيفين محدّدين جدًا أو أنماط مثل "‎*.com" على سبيل المثال.

ItemType

ما إذا كان المنتج في "سوق Chrome الإلكتروني" إضافة

عمليات التعداد
ITEM_TYPE_UNSPECIFIED نوع العنصر غير محدّد.
EXTENSION إضافات Chrome
OTHERS أي نوع آخر غير الإضافة

RiskAssessmentData

بيانات تقييم المخاطر حول إضافة أو تطبيق

تمثيل JSON 
{
  "entries": [
    {
      object (RiskAssessmentEntry)
    }
  ],
  "overallRiskLevel": enum (RiskLevel)
}
الحقول
entries[]

object (RiskAssessmentEntry)

تقييمات المخاطر الفردية
overallRiskLevel

enum (RiskLevel)

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

RiskAssessmentEntry

إدخال واحد لتقييم المخاطر

تمثيل JSON 
{
  "provider": enum (RiskAssessmentProvider),
  "riskAssessment": {
    object (RiskAssessment)
  },
  "riskLevel": enum (RiskLevel)
}
الحقول
provider

enum (RiskAssessmentProvider)

النتائج فقط. مقدّم خدمة تقييم المخاطر الذي تم الحصول على هذا الإدخال منه
riskAssessment

object (RiskAssessment)

النتائج فقط. تفاصيل تقييم المخاطر الذي أجراه مقدّم الخدمة
riskLevel

enum (RiskLevel)

النتائج فقط. مستوى المخاطر المجمّعة لتقييم المخاطر

RiskAssessmentProvider

مقدّمو خدمات تقييم المخاطر

عمليات التعداد
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED القيمة التلقائية في حال عدم تحديد مقدّم خدمة.
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR

تم إيقاف هذه الميزة نهائيًا: يُرجى استخدام مقدّمي خدمات آخرين لتقييم المخاطر بدلاً من ذلك. CRXcavator.
RISK_ASSESSMENT_PROVIDER_SPIN_AI

تم إيقاف هذه القيمة نهائيًا: يُرجى استخدام RISK_ASSESSMENT_PROVIDER_SPIN_AI_V2 بدلاً منها. Spin.Ai
RISK_ASSESSMENT_PROVIDER_LAYERX LayerX Security
RISK_ASSESSMENT_PROVIDER_SPIN_AI_V2 الإصدار 2 من Spin.AI

RiskAssessment

تقييم المخاطر لإضافة Chrome

تمثيل JSON 
{
  "assessment": string,
  "detailsUrl": string,
  "version": string
}
الحقول
assessment

string

تقييم المخاطر للإضافة في الوقت الحالي، هذه قيمة رقمية، ويختلف تفسيرها حسب كل مقدّم خدمة لتقييم المخاطر.
detailsUrl

string

عنوان URL يمكن للمستخدم الانتقال إليه للحصول على مزيد من المعلومات حول تقييم المخاطر
version

string

إصدار الإضافة الذي ينطبق عليه هذا التقييم

RiskLevel

مستوى الخطورة المجمّع لإضافة أو تطبيق

عمليات التعداد
RISK_LEVEL_UNSPECIFIED لم يتم تحديد مستوى الخطورة.
RISK_LEVEL_LOW إضافة تمثّل خطرًا منخفضًا
RISK_LEVEL_MEDIUM تمثّل الإضافة خطرًا متوسطًا.
RISK_LEVEL_HIGH إضافة تمثّل مخاطر عالية

AndroidAppInfo

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

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

object (AndroidAppPermission)

النتائج فقط. الأذونات التي يطلبها تطبيق Android

AndroidAppPermission

طلب الحصول على إذن من تطبيق Android.

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

string

النتائج فقط. نوع الإذن

الطُرق

get

 الحصول على تطبيق محدّد لعميل من خلال اسم المورد