REST Resource: enterprises

משאב: ארגוני

ההגדרה הוחלה על ארגון.

ייצוג JSON 
{
  "name": string,
  "enabledNotificationTypes": [
    enum (NotificationType)
  ],
  "pubsubTopic": string,
  "primaryColor": integer,
  "logo": {
    object (ExternalData)
  },
  "enterpriseDisplayName": string,
  "termsAndConditions": [
    {
      object (TermsAndConditions)
    }
  ],
  "appAutoApprovalEnabled": boolean,
  "signinDetails": [
    {
      object (SigninDetail)
    }
  ],
  "contactInfo": {
    object (ContactInfo)
  }
}
שדות
name

string

שם הארגון שהשרת יוצר על ידי השרת במהלך היצירה, בפורמט enterprises/{enterpriseId}.
enabledNotificationTypes[]

enum (NotificationType)

סוגי ההתראות של Google Pub/Sub שמופעלות בארגון.
pubsubTopic

string

הנושא שאליו מתפרסמות התראות ב-Pub/Sub, בפורמט projects/{project}/topics/{topic}. השדה הזה נדרש רק אם ההתראות ב-Pub/Sub מופעלות.
primaryColor

integer

צבע בפורמט RGB שמציין את הצבע העיקרי שיש להציג בממשק המשתמש של אפליקציית ניהול המכשירים. רכיבי הצבעים מאוחסנים באופן הבא: (red << 16) | (green << 8) | blue, כאשר הערך של כל רכיב הוא בין 0 ל-255, כולל.
enterpriseDisplayName

string

שם הארגון שמוצג למשתמשים. האורך המקסימלי של השדה הוא 100 תווים.
termsAndConditions[]

object (TermsAndConditions)

תנאים והגבלות שיש לאשר כשמקצים מכשיר לארגון הזה. לכל ערך ברשימה הזו נוצר דף של מונחים.
appAutoApprovalEnabled
(deprecated)

boolean

הוצא משימוש ולא נמצא בשימוש.
signinDetails[]

object (SigninDetail)

פרטי הכניסה של הארגון.
contactInfo

object (ContactInfo)

הפרטים ליצירת קשר של ארגון שמנוהל על ידי EMM.

NotificationType

סוגי ההתראות ששרת ניהול המכשירים עשוי לשלוח דרך Google Pub/Sub.

טיפוסים בני מנייה (enums)
NOTIFICATION_TYPE_UNSPECIFIED המערכת מתעלמת מהערך הזה.
ENROLLMENT התראה נשלחת כשמתבצעת הרשמה של מכשיר
COMPLIANCE_REPORT

הוּצא משימוש.
STATUS_REPORT התראה שנשלחת כשמכשיר מנפיק דוח סטטוס.
COMMAND התראה נשלחת אחרי שמתבצעת פקודה במכשיר.
USAGE_LOGS התראה נשלחת כשהמכשיר שולח את BatchUsageLogEvents.

ExternalData

נתונים שמתארחים במיקום חיצוני. הורדת הנתונים תתבצע על ידי Android Device Policy ואימות מול גיבוב (hash).

ייצוג JSON 
{
  "url": string,
  "sha256Hash": string
}
שדות
url

string

כתובת ה-URL המוחלטת של הנתונים, שחייבת להשתמש בסכמת http או https. האפליקציה 'מדיניות מכשיר' של Android לא מספקת פרטי כניסה בבקשת ה-GET, ולכן כתובת ה-URL חייבת להיות נגישה לכולם. כדי למנוע מתוקפים לגלות את כתובת ה-URL, ניתן לכלול רכיב ארוך ואקראי בכתובת ה-URL.
sha256Hash

string

גיבוב SHA-256 בקידוד Base-64 של התוכן שמתארח בכתובת ה-URL. אם התוכן לא תואם הגיבוב הזה, אפליקציית Android Device Policy לא תשתמש בנתונים.

TermsAndConditions

דף תנאים והגבלות שצריך לאשר במהלך ניהול ההקצאות.

ייצוג JSON 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
שדות
header

object (UserFacingMessage)

כותרת קצרה שמופיעה מעל תוכן ה-HTML.
content

object (UserFacingMessage)

מחרוזת 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 (AllowPersonalUsage),
  "tokenTag": string
}
שדות
signinUrl

string

כתובת URL לכניסה לצורך אימות, כשהמכשיר מוקצה באמצעות אסימון רישום לכניסה. נקודת הקצה לכניסה צריכה לסיים את תהליך האימות באמצעות כתובת URL בפורמט https://enterprise.google.com/android/enroll?et= להתחברות מוצלחת, או בכתובת https://enterprise.google.com/android/enroll/invalid במקרה של התחברות שנכשלה.
signinEnrollmentToken

string

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

string

מחרוזת JSON שייצוג UTF-8 שלה יכול לשמש ליצירת קוד QR כדי לרשום מכשיר עם אסימון הרישום הזה. כדי לרשום מכשיר באמצעות NFC, רשומת ה-NFC חייבת להכיל ייצוג java.util.Properties בהסדרה של הנכסים ב-JSON. זהו שדה לקריאה בלבד שנוצר על ידי השרת.
allowPersonalUsage

enum (AllowPersonalUsage)

המדיניות הזו קובעת אם השימוש האישי מותר במכשיר שהוקצה לו אסימון הרישום הזה.

למכשירים בבעלות החברה:

  • הפעלת שימוש אישי מאפשרת למשתמש להגדיר פרופיל עבודה במכשיר.
  • כדי להשבית את השימוש האישי, המשתמש צריך להקצות את המכשיר כמכשיר מנוהל באופן מלא.

למכשירים בבעלות אישית:

  • הפעלת שימוש אישי מאפשרת למשתמש להגדיר פרופיל עבודה במכשיר.
  • השבתת השימוש האישי תמנע את ניהול התצורה של המכשיר. לא ניתן להשבית שימוש אישי במכשיר בבעלות אישית.
tokenTag

string

מטא-נתונים שהוגדרו על ידי EMM, שנועדו להבחין בין מופעים של SigninDetail.

ContactInfo

פרטים ליצירת קשר עם ארגוני Google Play לארגונים.

ייצוג JSON 
{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
שדות
contactEmail

string

כתובת אימייל של איש קשר שתשמש לשליחת הודעות חשובות בקשר ל-Google Play לארגונים.
dataProtectionOfficerName

string

שם האחראי על הגנת המידע.
dataProtectionOfficerEmail

string

כתובת האימייל של האחראי על הגנת המידע. כתובת האימייל מאומתת אבל לא מאומתת.
dataProtectionOfficerPhone

string

מספר הטלפון של האחראי להגנה על המידע. מספר הטלפון מאומת, אך לא מאומת.
euRepresentativeName

string

שם הנציג באיחוד האירופי.
euRepresentativeEmail

string

כתובת האימייל של הנציג באיחוד האירופי. כתובת האימייל מאומתת אבל לא מאומתת.
euRepresentativePhone

string

מספר הטלפון של הנציג באיחוד האירופי. מספר הטלפון מאומת אבל לא מאומת.

שיטות

create

 יצירת ארגון.

delete

 מחיקה סופית של ארגון וכל החשבונות והנתונים המשויכים אליו.

get

 מגיע לארגון.

list

 רשימה של ארגונים שמנוהלים על ידי EMM.

patch

 עדכון ארגון.