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)

פלט בלבד. מועד הפרסום הראשון.

חותמת זמן בפורמט 'Zulu' בפורמט RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות אחרי הנקודה. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

latestPublishTime

string (Timestamp format)

פלט בלבד. מועד הפרסום האחרון.

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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

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

טיפוסים בני מנייה (enum)
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

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

isKioskOnly

boolean

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

טיפוסים בני מנייה (enum)
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 מגדיר מודל שגיאה לוגי שמתאים לסביבות תכנות שונות, כולל ממשקי API ל-REST וממשקי API ל-RPC. הוא משמש את gRPC. כל הודעה מסוג Status מכילה שלושה נתונים: קוד שגיאה, הודעת שגיאה ופרטי השגיאה.

מידע נוסף על מודל השגיאות הזה ועל אופן העבודה איתו זמין במדריך לעיצוב API.

ייצוג JSON
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
שדות
code

integer

קוד הסטטוס, שצריך להיות ערך enum של google.rpc.Code.

message

string

הודעת שגיאה למפתחים, שצריכה להיות באנגלית. כל הודעת שגיאה שמוצגת למשתמשים צריכה להיות מותאמת לשוק המקומי ולשלוח אותה בשדה google.rpc.Status.details או להתאים אותה לשוק המקומי.

details[]

object

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

אובייקט שמכיל שדות מסוג שרירותי. שדה נוסף "@type" מכיל URI המזהה את הסוג. לדוגמה: { "id": 1234, "@type": "types.example.com/standard/id" }.

שיטות

get

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