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

النتائج فقط. الصفحة الرئيسية أو معرّف الموارد المنتظم (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

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