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, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

latestPublishTime

string (Timestamp format)

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

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

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

טיפוסים בני מנייה (enums)
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 הוא תוסף.

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

AndroidAppInfo

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

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

object (AndroidAppPermission)

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

AndroidAppPermission

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

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

string

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

סטטוס

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

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