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

النتائج فقط. عنوان URL لصفحة تفاصيل المنتج.
firstPublishTime

string (Timestamp format)

النتائج فقط. وقت النشر لأول مرة

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
latestPublishTime

string (Timestamp format)

النتائج فقط. وقت آخر نشر

يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu"‎ وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z"
publisher

string

النتائج فقط. ناشر المحتوى
isPaidApp

boolean

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

string

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

string

النتائج فقط. عنوان URL الذي يشير إلى سياسة خصوصية التطبيق، إذا كان المطوّر قد قدّمه حقل خاص بالإصدار لن يتم ضبطه إلا عند العثور على إصدار التطبيق المطلوب.
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
}
الحقول
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

النتائج فقط. ما إذا كان التطبيق يتيح استخدام سياسات للإضافات.

ChromeAppPermission

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

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

string

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

string

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

boolean

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

ChromeAppSiteAccess

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

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

string

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

ItemType

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

عمليات التعداد
ITEM_TYPE_UNSPECIFIED نوع العنصر غير محدّد.
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" الإضافي على معرّف موارد منتظم يحدّد النوع. مثال: { "id": 1234, "@type": "types.example.com/standard/id" }

الطُرق

get

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