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
  ],

  // 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" لإضافة 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

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

حقل الربط 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 API وRPC API. يتم استخدامه من خلال 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

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