Grouplicenses

רשימה של ה-methods במשאב הזה מופיעה בסוף הדף.

ייצוגי משאבים

אובייקטים של רישיון קבוצתי מאפשרים לעקוב אחרי רישיונות (שנקראים הרשאות) של אפליקציות בחינם וגם של אפליקציות בתשלום. באפליקציה חינמית, נוצר רישיון קבוצתי כשאדמין בארגון מאשר לראשונה את המוצר ב-Google Play, או כשיוצרים את ההרשאה הראשונה למוצר דרך ה-API. באפליקציה בתשלום, אובייקט של רישיון קבוצתי נוצר רק כשאדמין בארגון רוכש את המוצר בפעם הראשונה ב-Google Play.

שימוש ב-API כדי להריץ שאילתות על רישיונות של קבוצות. משאב Grouplicenses כולל את המספר הכולל של הרישיונות שנרכשו (אפליקציות בתשלום בלבד) ואת המספר הכולל של הרישיונות שנמצאים כרגע בשימוש. במילים אחרות, המספר הכולל של ערכי Entitlements שקיימים עבור המוצר.

רק אובייקט אחד של רישיון קבוצה נוצר לכל אובייקט של רישיון קבוצה או מוצר, ואף פעם לא נמחק. אם מוצר לא אושר, הרישיון הקבוצתי שלו נשאר. כך אדמינים בארגון יכולים לעקוב אחרי הרשאות נוספות של המוצר.

{
  "kind": "androidenterprise#groupLicense",
  "productId": string,
  "numPurchased": integer,
  "numProvisioned": integer,
  "acquisitionKind": string,
  "approval": string,
  "permissions": string
}
שם הנכס ערך תיאור הערות
acquisitionKind string איך נרכש הרישיון הקבוצתי הזה. המשמעות של "bulkPurchase" היא שהמשאב הזה של רישיונות קבוצה נוצר כי הארגון רכש רישיונות למוצר הזה. אחרת, הערך הוא "free" (למוצרים בחינם).

הערכים הקבילים הם:
  • "bulkPurchase"
  • "free"
approval string האם המוצר שאליו קשור הרישיון של הקבוצה מאושר כרגע על ידי הארגון. מוצרים מקבלים אישור כשיוצרים רישיון קבוצתי, אבל אדמין בארגון יכול לבטל את האישור הזה דרך Google Play. מוצרים שלא אושרו לא יוצגו למשתמשי קצה באוספים, ובדרך כלל לא ניתן ליצור הרשאות חדשות לגביהם.

הערכים הקבילים הם:
  • "approved"
  • "unapproved"
kind string
numProvisioned integer המספר הכולל של הרישיונות שהוקצו למוצר הזה. מוחזר על ידי פעולות קריאה, אבל מתעלמים מהן בפעולות כתיבה.
numPurchased integer מספר הרישיונות שנרכשו (כנראה ברכישות מרובות). אם לא מציינים את השדה הזה, אין הגבלה על מספר הרישיונות שאפשר להקצות (לדוגמה, אם סוג צירוף המשתמשים הוא "free").
permissions string סטטוס אישור ההרשאות של המוצר. השדה הזה מוגדר רק אם המוצר אושר. המדינות האפשריות הן:
  • 'currentApproved', קבוצת ההרשאות הנוכחית מאושרת, אבל לפי הרשאות נוספות האדמין יצטרך לאשר מחדש את המוצר (אם המוצר אושר בלי לציין את ההגדרה של ההרשאות שאושרו, זאת התנהגות ברירת המחדל).
  • 'needsReapproval', למוצר יש הרשאות שלא אושרו. לא ניתן להקצות רישיונות מוצר נוספים עד שהמוצר יאושר מחדש.
  • 'allCurrentAndFutureApproved', ההרשאות הנוכחיות אושרו וכל עדכון עתידי לגבי הרשאות יאושרו באופן אוטומטי ללא בדיקה של האדמין.


הערכים הקבילים הם:
  • "allCurrentAndFutureApproved"
  • "currentApproved"
  • "needsReapproval"
productId string המזהה של המוצר שעבורו מיועד הרישיון. לדוגמה, "app:com.google.android.gm".

שיטות

הורדה
אחזור פרטים של רישיון קבוצתי של מוצר מסוים.
list
אחזור מזהים של כל המוצרים שלארגון יש רישיון קבוצתי שלהם.