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

פלט בלבד. מזהה החנות הייחודי של הפריט. דוגמאות: "gmbmikajgmnabiglmofipeabaddhgne" לתוסף 'שמירה ב-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

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

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

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