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)

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

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

latestPublishTime

string (Timestamp format)

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

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

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
}
الحقول
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

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

accessUserData

boolean

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

ChromeAppSiteAccess

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

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

string

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

ItemType

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

عمليات التعداد
ITEM_TYPE_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

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