משאב: ארגוני
ההגדרה הוחלה על ארגון.
ייצוג JSON |
---|
{ "name": string, "enabledNotificationTypes": [ enum ( |
שדות | |
---|---|
name |
שם הארגון שהשרת יוצר על ידי השרת במהלך היצירה, בפורמט |
enabledNotificationTypes[] |
סוגי ההתראות של Google Pub/Sub שמופעלות בארגון. |
pubsubTopic |
הנושא שאליו מתפרסמות התראות ב-Pub/Sub, בפורמט |
primaryColor |
צבע בפורמט RGB שמציין את הצבע העיקרי שיש להציג בממשק המשתמש של אפליקציית ניהול המכשירים. רכיבי הצבעים מאוחסנים באופן הבא: |
logo |
תמונה שמוצגת כלוגו בזמן הקצאת המכשיר. הסוגים הנתמכים הם: image/bmp, image/gif, image/x-ico, image/jpeg, image/png, image/webp, image/vnd.wap.wbmp, image/x-adobe-dng. |
enterpriseDisplayName |
שם הארגון שמוצג למשתמשים. האורך המקסימלי של השדה הוא 100 תווים. |
termsAndConditions[] |
תנאים והגבלות שיש לאשר כשמקצים מכשיר לארגון הזה. לכל ערך ברשימה הזו נוצר דף של מונחים. |
appAutoApprovalEnabled |
הוצא משימוש ולא נמצא בשימוש. |
signinDetails[] |
פרטי הכניסה של הארגון. |
contactInfo |
הפרטים ליצירת קשר של ארגון שמנוהל על ידי EMM. |
NotificationType
סוגי ההתראות ששרת ניהול המכשירים עשוי לשלוח דרך Google Pub/Sub.
טיפוסים בני מנייה (enums) | |
---|---|
NOTIFICATION_TYPE_UNSPECIFIED |
המערכת מתעלמת מהערך הזה. |
ENROLLMENT |
התראה נשלחת כשמתבצעת הרשמה של מכשיר |
COMPLIANCE_REPORT |
הוּצא משימוש. |
STATUS_REPORT |
התראה שנשלחת כשמכשיר מנפיק דוח סטטוס. |
COMMAND |
התראה נשלחת אחרי שמתבצעת פקודה במכשיר. |
USAGE_LOGS |
התראה נשלחת כשהמכשיר שולח את . |
ExternalData
נתונים שמתארחים במיקום חיצוני. הורדת הנתונים תתבצע על ידי Android Device Policy ואימות מול גיבוב (hash).
ייצוג JSON |
---|
{ "url": string, "sha256Hash": string } |
שדות | |
---|---|
url |
כתובת ה-URL המוחלטת של הנתונים, שחייבת להשתמש בסכמת http או https. האפליקציה 'מדיניות מכשיר' של Android לא מספקת פרטי כניסה בבקשת ה-GET, ולכן כתובת ה-URL חייבת להיות נגישה לכולם. כדי למנוע מתוקפים לגלות את כתובת ה-URL, ניתן לכלול רכיב ארוך ואקראי בכתובת ה-URL. |
sha256Hash |
גיבוב SHA-256 בקידוד Base-64 של התוכן שמתארח בכתובת ה-URL. אם התוכן לא תואם הגיבוב הזה, אפליקציית Android Device Policy לא תשתמש בנתונים. |
TermsAndConditions
דף תנאים והגבלות שצריך לאשר במהלך ניהול ההקצאות.
ייצוג JSON |
---|
{ "header": { object ( |
שדות | |
---|---|
header |
כותרת קצרה שמופיעה מעל תוכן ה-HTML. |
content |
מחרוזת HTML בפורמט תקין. הוא ינותח בלקוח באמצעות android.text.Html#fromHtml. |
SigninDetail
משאב שמכיל פרטי כניסה של ארגון. אפשר להשתמש ב-
כדי לנהל את enterprises
SigninDetail
עבור ארגון נתון.
עבור ארגון, אנחנו יכולים לציין כל מספר של SigninDetail
שמזוהה באופן ייחודי על ידי שילוב של שלושת השדות הבאים (signinUrl
, allowPersonalUsage
, tokenTag
). לא ניתן ליצור שני שדות SigninDetail
עם אותו ערך (signinUrl
, allowPersonalUsage
, tokenTag
). (tokenTag
הוא שדה אופציונלי).
: הפעולה מעדכנת את הרשימה הנוכחית של Patch
SigninDetails
בעזרת הרשימה החדשה של SigninDetails
.
- אם ההגדרה של
SigninDetail
ששמורה מועברת, היא מחזירה את אותןsigninEnrollmentToken
וגםqrCode
. - אם נעביר כמה הגדרות זהות של
SigninDetail
שלא שמורות, המערכת תאחסן את ההגדרה הראשונה מבין אלה שלSigninDetail
. - אם התצורה כבר קיימת, לא ניתן לבקש אותה יותר מפעם אחת בקריאת API מסוימת לתיקון. אחרת, תתקבל שגיאת מפתח כפולה והפעולה כולה תיכשל.
- אם נסיר מהבקשה הגדרות אישיות מסוימות של
SigninDetail
, הן יוסרו מהאחסון. לאחר מכן נוכל לבקש עודsigninEnrollmentToken
ו-qrCode
עבור אותה הגדרתSigninDetail
.
ייצוג JSON |
---|
{
"signinUrl": string,
"signinEnrollmentToken": string,
"qrCode": string,
"allowPersonalUsage": enum ( |
שדות | |
---|---|
signinUrl |
כתובת URL לכניסה לצורך אימות, כשהמכשיר מוקצה באמצעות אסימון רישום לכניסה. נקודת הקצה לכניסה צריכה לסיים את תהליך האימות באמצעות כתובת URL בפורמט https://enterprise.google.com/android/enroll?et= |
signinEnrollmentToken |
אסימון רישום ברמת הארגון, שמשמש להפעלה של תהליך כניסה בהתאמה אישית. זהו שדה לקריאה בלבד שנוצר על ידי השרת. |
qrCode |
מחרוזת JSON שייצוג UTF-8 שלה יכול לשמש ליצירת קוד QR כדי לרשום מכשיר עם אסימון הרישום הזה. כדי לרשום מכשיר באמצעות NFC, רשומת ה-NFC חייבת להכיל ייצוג |
allowPersonalUsage |
המדיניות הזו קובעת אם השימוש האישי מותר במכשיר שהוקצה לו אסימון הרישום הזה. למכשירים בבעלות החברה:
למכשירים בבעלות אישית:
|
tokenTag |
מטא-נתונים שהוגדרו על ידי EMM, שנועדו להבחין בין מופעים של |
ContactInfo
פרטים ליצירת קשר עם ארגוני Google Play לארגונים.
ייצוג JSON |
---|
{ "contactEmail": string, "dataProtectionOfficerName": string, "dataProtectionOfficerEmail": string, "dataProtectionOfficerPhone": string, "euRepresentativeName": string, "euRepresentativeEmail": string, "euRepresentativePhone": string } |
שדות | |
---|---|
contactEmail |
כתובת אימייל של איש קשר שתשמש לשליחת הודעות חשובות בקשר ל-Google Play לארגונים. |
dataProtectionOfficerName |
שם האחראי על הגנת המידע. |
dataProtectionOfficerEmail |
כתובת האימייל של האחראי על הגנת המידע. כתובת האימייל מאומתת אבל לא מאומתת. |
dataProtectionOfficerPhone |
מספר הטלפון של האחראי להגנה על המידע. מספר הטלפון מאומת, אך לא מאומת. |
euRepresentativeName |
שם הנציג באיחוד האירופי. |
euRepresentativeEmail |
כתובת האימייל של הנציג באיחוד האירופי. כתובת האימייל מאומתת אבל לא מאומתת. |
euRepresentativePhone |
מספר הטלפון של הנציג באיחוד האירופי. מספר הטלפון מאומת אבל לא מאומת. |
שיטות |
|
---|---|
|
יצירת ארגון. |
|
מחיקה סופית של ארגון וכל החשבונות והנתונים המשויכים אליו. |
|
מגיע לארגון. |
|
רשימה של ארגונים שמנוהלים על ידי EMM. |
|
עדכון ארגון. |