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)
  },

  // Union field app_info can be only one of the following:
  "chromeAppInfo": {
    object (ChromeAppInfo)
  },
  "androidAppInfo": {
    object (AndroidAppInfo)
  }
  // End of list of possible types for union field app_info.
}
الحقول
name

string

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

string

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

string

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

string

النتائج فقط. تمثّل هذه السمة المعرّف الفريد للمتجر الخاص بالسلعة. أمثلة: "gmbmikajjgmnabiglmofipeabaddhgne" لإضافة "حفظ في Google Drive" على Chrome، و"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-normalized ويستخدم 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-normalized ويستخدم 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)

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

حقل الدمج app_info

يمكن أن تكون app_info إحدى القيم التالية فقط:
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),
  "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 الإلكتروني"
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 Unspecified ItemType.
EXTENSION إضافات Chrome
OTHERS أي نوع آخر غير الإضافة

AndroidAppInfo

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

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

object (AndroidAppPermission)

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

AndroidAppPermission

إذن يطلبه أحد تطبيقات Android

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

string

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

الحالة

يحدّد النوع Status نموذج خطأ منطقيًا مناسبًا لبيئات البرمجة المختلفة، بما في ذلك واجهات برمجة التطبيقات REST وRPC. يتم استخدامها من خلال gRPC. تحتوي كل رسالة Status على ثلاثة أجزاء من البيانات: رمز الخطأ ورسالة الخطأ وتفاصيل الخطأ.

يمكنك الاطّلاع على مزيد من المعلومات حول نموذج الخطأ هذا وكيفية التعامل معه في دليل تصميم واجهة برمجة التطبيقات.

تمثيل JSON 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
الحقول
code

integer

رمز الحالة، ويجب أن تكون قيمة تعدادية من google.rpc.Code.
message

string

رسالة خطأ موجّهة إلى المطوّرين، ويجب أن تكون باللغة الإنجليزية. يجب ترجمة أي رسالة خطأ تظهر للمستخدم وإرسالها في الحقل google.rpc.Status.details، أو ترجمتها من قِبل العميل.
details[]

object

قائمة بالرسائل التي تتضمّن تفاصيل الخطأ هناك مجموعة شائعة من أنواع الرسائل التي يمكن أن تستخدمها واجهات برمجة التطبيقات.

كائن يحتوي على حقول من أي نوع. يحتوي حقل إضافي "@type" على معرّف موارد منتظم (URI) يحدّد النوع. مثال: { "id": 1234, "@type": "types.example.com/standard/id" }

الطُرق

get

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