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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "chromeAppInfo": {
    object (ChromeAppInfo)
  },
  "androidAppInfo": {
    object (AndroidAppInfo)
  }
  // End of mutually exclusive fields.
}
שדות
name

string

פלט בלבד. פורמט: name=customers/{customerId}/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

פלט בלבד. מזהי הקטגוריות של האפליקציה, שזהים לאלה ששמורים בפריט בחנות האינטרנט. אפשר להזין רק מזהה קטגוריה אחד.

ברשימה הבאה מופיעים שדות שמוציאים זה את זה. בתשובה יוגדר לכל היותר אחד מהשדות הבאים:
chromeAppInfo

object (ChromeAppInfo)

פלט בלבד. פרטי האפליקציה בחנות האינטרנט של Chrome.

androidAppInfo

object (AndroidAppInfo)

פלט בלבד. מידע על אפליקציות ל-Android.

סוף השדות שמוציאים זה את זה.

AppItemType

סוג האפליקציה.

טיפוסים בני מנייה (enum)
APP_ITEM_TYPE_UNSPECIFIED לא צוין סוג האפליקציה.
CHROME אפליקציית Chrome.
ANDROID אפליקציית ARC++‎.
WEB אפליקציית אינטרנט.

ChromeAppInfo

פרטי האפליקציה בחנות האינטרנט של Chrome.

ייצוג ב-JSON
{
  "minUserCount": integer,
  "permissions": [
    {
      object (ChromeAppPermission)
    }
  ],
  "siteAccess": [
    {
      object (ChromeAppSiteAccess)
    }
  ],
  "type": enum (ItemType),
  "riskAssessment": {
    object (RiskAssessmentData)
  },
  "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

riskAssessment

object (RiskAssessmentData)

פלט בלבד. מכיל נתונים של הערכת סיכונים לגבי התוסף ל-Chrome.

supportEnabled

boolean

פלט בלבד. מפתח האפליקציה הפעיל תמיכה באפליקציה שלו. שדה ספציפי לגרסה שיוגדר רק כשגרסת האפליקציה המבוקשת תימצא.

isTheme

boolean

פלט בלבד. אם האפליקציה או התוסף הם עיצוב.

googleOwned

boolean

פלט בלבד. אם האפליקציה או התוסף פותחו ומתוחזקים על ידי Google. שדה ספציפי לגרסה שיוגדר רק כשגרסת האפליקציה המבוקשת תימצא.

isCwsHosted

boolean

פלט בלבד. אם האפליקציה או התוסף פורסמו בחנות האינטרנט של Chrome.

kioskEnabled

boolean

פלט בלבד. אם האפליקציה הזו מופעלת במצב קיוסק במכשירי ChromeOS

isKioskOnly

boolean

פלט בלבד. אם האפליקציה מיועדת רק למצב קיוסק במכשירי 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 הוא תוסף.

טיפוסים בני מנייה (enum)
ITEM_TYPE_UNSPECIFIED סוג הפריט לא צוין.
EXTENSION תוספים ל-Chrome.
OTHERS כל סוג אחר מלבד תוסף.

RiskAssessmentData

נתונים של הערכת סיכונים לגבי תוסף או אפליקציה.

ייצוג ב-JSON
{
  "entries": [
    {
      object (RiskAssessmentEntry)
    }
  ],
  "overallRiskLevel": enum (RiskLevel)
}
שדות
entries[]

object (RiskAssessmentEntry)

הערכות סיכונים ספציפיות.

overallRiskLevel

enum (RiskLevel)

רמת הסיכון הכוללת שנקבעה לכל הרשומות. זו תהיה רמת הסיכון הגבוהה ביותר מכל הרשומות.

RiskAssessmentEntry

רשומה אחת של הערכת סיכונים.

ייצוג ב-JSON
{
  "provider": enum (RiskAssessmentProvider),
  "riskAssessment": {
    object (RiskAssessment)
  },
  "riskLevel": enum (RiskLevel)
}
שדות
provider

enum (RiskAssessmentProvider)

פלט בלבד. הספק של הערכת הסיכונים שממנו מגיע הערך הזה.

riskAssessment

object (RiskAssessment)

פלט בלבד. פרטי הערכת הסיכונים של הספק.

riskLevel

enum (RiskLevel)

פלט בלבד. רמת הסיכון המקובצת להערכת הסיכונים.

RiskAssessmentProvider

ספקים של הערכת סיכונים.

טיפוסים בני מנייה (enum)
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED ערך ברירת המחדל כשלא צוין ספק.
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR

הוצא משימוש: צריך להשתמש בספקים אחרים של ציוני סיכון. CRXcavator.

RISK_ASSESSMENT_PROVIDER_SPIN_AI

הוצא משימוש: במקום זאת צריך להשתמש ב-RISK_ASSESSMENT_PROVIDER_SPIN_AI_V2. Spin.Ai.

RISK_ASSESSMENT_PROVIDER_LAYERX ‫LayerX Security.
RISK_ASSESSMENT_PROVIDER_SPIN_AI_V2 ‫Spin.AI V2.

RiskAssessment

הערכת סיכונים של תוסף ל-Chrome.

ייצוג ב-JSON
{
  "assessment": string,
  "detailsUrl": string,
  "version": string
}
שדות
assessment

string

הערכת הסיכונים לגבי התוסף. נכון לעכשיו, זהו ערך מספרי, והפרשנות שלו ספציפית לכל ספק של הערכת סיכונים.

detailsUrl

string

כתובת URL שהמשתמש יכול לעבור אליה כדי לקבל מידע נוסף על הערכת הסיכונים.

version

string

גרסת התוסף שההערכה הזו רלוונטית לגביה.

RiskLevel

רמת הסיכון של תוסף או אפליקציה לפי קטגוריות.

טיפוסים בני מנייה (enum)
RISK_LEVEL_UNSPECIFIED רמת הסיכון לא צוינה.
RISK_LEVEL_LOW תוסף שמייצג סיכון נמוך.
RISK_LEVEL_MEDIUM תוסף שמייצג סיכון בינוני.
RISK_LEVEL_HIGH תוסף שמייצג סיכון גבוה.

AndroidAppInfo

מידע על אפליקציות ל-Android.

ייצוג ב-JSON
{
  "permissions": [
    {
      object (AndroidAppPermission)
    }
  ]
}
שדות
permissions[]

object (AndroidAppPermission)

פלט בלבד. הרשאות שנדרשות לאפליקציה ל-Android.

AndroidAppPermission

בקשת הרשאה של אפליקציה ל-Android.

ייצוג ב-JSON
{
  "type": string
}
שדות
type

string

פלט בלבד. סוג ההרשאה.

Methods

get

אפשר לקבל אפליקציה ספציפית ללקוח לפי שם המשאב שלה.