REST Resource: enterprises.applications

משאב: אפליקציה

מידע על אפליקציה.

ייצוג JSON 
{
  "name": string,
  "title": string,
  "permissions": [
    {
      object (ApplicationPermission)
    }
  ],
  "managedProperties": [
    {
      object (ManagedProperty)
    }
  ],
  "iconUrl": string,
  "smallIconUrl": string,
  "appTracks": [
    {
      object (AppTrackInfo)
    }
  ],
  "author": string,
  "playStoreUrl": string,
  "distributionChannel": enum (DistributionChannel),
  "appPricing": enum (AppPricing),
  "description": string,
  "screenshotUrls": [
    string
  ],
  "category": string,
  "recentChanges": string,
  "minAndroidSdkVersion": integer,
  "contentRating": enum (ContentRating),
  "updateTime": string,
  "availableCountries": [
    string
  ],
  "features": [
    enum (AppFeature)
  ],
  "appVersions": [
    {
      object (AppVersion)
    }
  ],
  "fullDescription": string
}
שדות
name

string

שם האפליקציה בפורמט enterprises/{enterprise}/applications/{packageName}.
title

string

שם האפליקציה. מותאם לשוק המקומי.
permissions[]

object (ApplicationPermission)

ההרשאות הנדרשות לאפליקציה.
managedProperties[]

object (ManagedProperty)

קבוצת הנכסים המנוהלים שזמינים להגדרה מראש באפליקציה.
iconUrl

string

קישור לתמונה שיכולה לשמש כסמל של האפליקציה. תמונה זו מתאימה לשימוש בגודל של עד 512x512 פיקסלים.
smallIconUrl

string

קישור לתמונה קטנה יותר שאפשר להשתמש בה כסמל של האפליקציה. התמונה הזו מתאימה לשימוש בגודל של עד 128 על 128 פיקסלים.
appTracks[]

object (AppTrackInfo)

מעקב אחר אפליקציות גלוי לארגון.
author

string

שם המחבר של האפליקציות (לדוגמה, מפתח האפליקציה).
playStoreUrl

string

קישור לדף הפרטים של האפליקציה ב-Google Play (לצרכן).
distributionChannel

enum (DistributionChannel)

איך החבילה זמינה למי היא זמינה.
appPricing

enum (AppPricing)

האם האפליקציה הזו חינמית, חינמית עם רכישות מתוך האפליקציה או בתשלום. אם לא צוין מחיר, סימן שהאפליקציה כבר לא זמינה לכולם (למרות שהיא עשויה להיות עדיין זמינה לאנשים שבבעלותם היא).
description

string

התיאור המקומי של קידום המכירות, אם הוא זמין.
screenshotUrls[]

string

רשימה של קישורים לצילומי מסך שמייצגים את האפליקציה.
category

string

קטגוריית האפליקציה (למשל: RACING,‏ SOCIAL וכו')
recentChanges

string

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

integer

גרסת ה-SDK המינימלית ל-Android שנדרשת להרצת האפליקציה.
contentRating

enum (ContentRating)

סיווג התוכן של האפליקציה הזו.
updateTime

string (Timestamp format)

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

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

string

המדינות שבהן האפליקציה הזו זמינה, בהתאם לתקן ISO 3166-1 alpha-2.
features[]

enum (AppFeature)

תכונות מעניינות (אם יש) של האפליקציה הזו.
appVersions[]

object (AppVersion)

הגרסאות שזמינות כרגע לאפליקציה הזו.
fullDescription

string

תיאור מלא של האפליקציה, אם יש.

ApplicationPermission

הרשאה שנדרשת לאפליקציה.

ייצוג JSON 
{
  "permissionId": string,
  "name": string,
  "description": string
}
שדות
permissionId

string

מחרוזת אטומה שמזהה באופן ייחודי את ההרשאה. לא מותאם לשוק המקומי.
name

string

שם ההרשאה. מותאם לשוק המקומי.
description

string

תיאור ארוך יותר של ההרשאה, עם פרטים נוספים על הגורמים שהיא משפיעה עליהם. מותאם לשוק המקומי.

ManagedProperty

נכס מנוהל.

ייצוג ב-JSON 
{
  "key": string,
  "type": enum (ManagedPropertyType),
  "title": string,
  "description": string,
  "entries": [
    {
      object (ManagedPropertyEntry)
    }
  ],
  "defaultValue": value,
  "nestedProperties": [
    {
      object (ManagedProperty)
    }
  ]
}
שדות
key

string

המפתח הייחודי שבו האפליקציה משתמשת כדי לזהות את הנכס, למשל com.google.android.gm.fieldname.
type

enum (ManagedPropertyType)

סוג הנכס.
title

string

שם הנכס. מותאם לשוק המקומי.
description

string

תיאור ארוך יותר של הנכס, עם פרטים נוספים על האופן שבו הוא משפיע. מותאם לשוק המקומי.
entries[]

object (ManagedPropertyEntry)

במאפיינים CHOICE או MULTISELECT, רשימת הרשומות האפשריות.
defaultValue

value (Value format)

ערך ברירת המחדל של המאפיין. לנכסים ל-BUNDLE_ARRAY אין ערך ברירת מחדל.
nestedProperties[]

object (ManagedProperty)

בנכסי BUNDLE_ARRAY, רשימת הנכסים המוצבים בתוך רכיב. הנכס BUNDLE_ARRAY יכול להיות בעומק של עד שתי רמות.

ManagedPropertyType

סוג הנכס המנוהל.

טיפוסים בני מנייה (enum)
MANAGED_PROPERTY_TYPE_UNSPECIFIED לא בשימוש.
BOOL מאפיין מסוג בוליאני.
STRING מאפיין מסוג מחרוזת.
INTEGER מאפיין מסוג מספר שלם.
CHOICE בחירה של פריט אחד מתוך קבוצה.
MULTISELECT בחירה של כמה פריטים מתוך קבוצה.
HIDDEN הגבלה מוסתרת על סוג המחרוזת (אפשר להשתמש בערך ברירת המחדל כדי להעביר מידע שלא ניתן לשנות, כמו קוד גרסה).
BUNDLE חבילה של נכסים
BUNDLE_ARRAY מערך של חבילות נכסים.

ManagedPropertyEntry

רשומה של נכס מנוהל.

ייצוג ב-JSON 
{
  "value": string,
  "name": string
}
שדות
value

string

הערך של הרשומה שאפשר לקרוא במכונה, שבו צריך להשתמש בתצורה. לא מותאמים לשוק המקומי.
name

string

השם של הערך, שקריא לבני אדם. מותאם לשוק המקומי.

AppTrackInfo

מזהה השיוך של שם הטראק של האפליקציה.

ייצוג JSON 
{
  "trackId": string,
  "trackAlias": string
}
שדות
trackId

string

מזהה הטראק הייחודי שלא ניתן לשינוי, שנלקח מה-releaseTrackId בכתובת ה-URL של הדף ב-Play Console שבו מוצגים פרטי הטראק של האפליקציה.
trackAlias

string

שם הטראק שמשויך ל-trackId, שמוגדר ב-Play Console. אפשר לשנות את השם ב-Play Console.

DistributionChannel

ערוצי הפצה אפשריים.

טיפוסים בני מנייה (enum)
DISTRIBUTION_CHANNEL_UNSPECIFIED לא צוין.
PUBLIC_GOOGLE_HOSTED החבילה זמינה דרך חנות Play ולא מוגבלת לארגון ספציפי.
PRIVATE_GOOGLE_HOSTED החבילה היא אפליקציה פרטית (מוגבלת לארגון) אבל מתארחת על ידי Google.
PRIVATE_SELF_HOSTED אפליקציה פרטית (מוגבלת לארגון) שמתארחת באופן פרטי.

AppPricing

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

טיפוסים בני מנייה (enum)
APP_PRICING_UNSPECIFIED תמחור לא ידוע, שמציין אפליקציה שאושרה אבל לא זמינה לכולם.
FREE האפליקציה זמינה בחינם.
FREE_WITH_IN_APP_PURCHASE האפליקציה מוצעת בחינם, אבל מציעה רכישות מתוך האפליקציה.
PAID האפליקציה בתשלום.

ContentRating

סיווג התוכן לפי תקן כללי של IARC.

טיפוסים בני מנייה (enum)
CONTENT_RATING_UNSPECIFIED לא צוין.
THREE_YEARS תוכן שמתאים לגילאי 3 ומעלה בלבד.
SEVEN_YEARS תוכן שמתאים מגיל 7 ומעלה בלבד.
TWELVE_YEARS תוכן שמתאים לגילאי 12 ומעלה בלבד.
SIXTEEN_YEARS תוכן שמתאים לגילאי 16 ומעלה בלבד.
EIGHTEEN_YEARS תוכן שמתאים לצופים בגיל 18 ומעלה בלבד.

AppFeature

תכונות אפשריות של האפליקציה.

טיפוסים בני מנייה (enum)
APP_FEATURE_UNSPECIFIED לא צוין.
VPN_APP האפליקציה היא VPN.

AppVersion

הנתון הזה מייצג גרסה אחת של האפליקציה.

ייצוג ב-JSON 
{
  "versionString": string,
  "versionCode": integer,
  "trackIds": [
    string
  ],
  "production": boolean
}
שדות
versionString

string

המחרוזת שמפתח האפליקציה משתמש בה בחנות Play כדי לזהות את הגרסה. המחרוזת לא חייבת להיות ייחודית או מותאמת לשוק המקומי (לדוגמה, המחרוזת יכולה להיות '1.4').
versionCode

integer

מזהה ייחודי הולך וגדל של גרסת האפליקציה.
trackIds[]

string

מעקב אחר מזהים שבהם גרסת האפליקציה פורסמה. ההנחיה הזאת לא כוללת את המסלול לסביבת הייצור (אפשר לעיין במקום זאת בסביבת הייצור).
production

boolean

אם הערך הוא True, המשמעות היא שהגרסה הזו היא טראק לייצור.

שיטות

get

 מקבל מידע על אפליקציה.