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' לתוסף 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)

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

שדה איחוד 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,
  "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

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

AndroidAppInfo

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

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

object (AndroidAppPermission)

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

AndroidAppPermission

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

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

string

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

סטטוס

הסוג Status מגדיר מודל שגיאות לוגי שמתאים לסביבות תכנות שונות, כולל ממשקי API ל-REST ול-RPC. היא משמשת את gRPC. כל הודעת Status מכילה שלושה פריטי נתונים: קוד שגיאה, הודעת שגיאה ופרטי שגיאה.

מידע נוסף על מודל השגיאות הזה ועל אופן השימוש בו זמין ב-API Design Guide.

ייצוג ב-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" }

Methods

get

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