REST Resource: enterprises

Risorsa: Enterprise

La configurazione applicata a un'azienda.

Rappresentazione 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)
  }
}
Campi
name

string

Il nome dell'azienda generato dal server durante la creazione, nel formato enterprises/{enterpriseId}.
enabledNotificationTypes[]

enum (NotificationType)

I tipi di notifiche Google Pub/Sub abilitate per l'azienda.
pubsubTopic

string

L'argomento in cui sono pubblicate le notifiche Pub/Sub, nel formato projects/{project}/topics/{topic}. Questo campo è obbligatorio solo se sono abilitate le notifiche Pub/Sub.
primaryColor

integer

Un colore in formato RGB che indica il colore predominante da visualizzare nell'interfaccia utente dell'app di gestione dei dispositivi. I componenti di colore sono memorizzati come segue: (red << 16) | (green << 8) | blue, dove il valore di ogni componente è compreso tra 0 e 255 inclusi.
enterpriseDisplayName

string

Il nome dell'azienda mostrato agli utenti. Questo campo ha una lunghezza massima di 100 caratteri.
termsAndConditions[]

object (TermsAndConditions)

Termini e condizioni che è necessario accettare quando esegui il provisioning di un dispositivo per questa azienda. Viene generata una pagina di termini per ciascun valore in questo elenco.
appAutoApprovalEnabled
(deprecated)

boolean

Deprecata e non utilizzata.
signinDetails[]

object (SigninDetail)

Dati di accesso dell'azienda.
contactInfo

object (ContactInfo)

I dati di contatto aziendali di un'azienda gestita da EMM.

Tipo notifica

Tipi di notifiche che il server di gestione dei dispositivi può inviare tramite Google Pub/Sub.

Enum
NOTIFICATION_TYPE_UNSPECIFIED Questo valore viene ignorato.
ENROLLMENT Una notifica inviata quando un dispositivo si registra.
COMPLIANCE_REPORT

Deprecato.
STATUS_REPORT Una notifica inviata quando un dispositivo invia un report di stato.
COMMAND Una notifica inviata quando è stato completato un comando del dispositivo.
USAGE_LOGS Viene inviata una notifica quando il dispositivo invia BatchUsageLogEvents.

DatiEsterni

Dati ospitati in una posizione esterna. I dati devono essere scaricati da Android Device Policy e verificati utilizzando l'hash.

Rappresentazione JSON 
{
  "url": string,
  "sha256Hash": string
}
Campi
url

string

L'URL assoluto dei dati, che deve utilizzare lo schema http o https. Android Device Policy non fornisce credenziali nella richiesta GET, quindi l'URL deve essere accessibile pubblicamente. L'inclusione di un componente lungo e casuale nell'URL potrebbe essere utilizzato per impedire ai malintenzionati di scoprirlo.
sha256Hash

string

L'hash SHA-256 con codifica Base64 dei contenuti ospitati all'URL. Se i contenuti non corrispondono a questo hash, Android Device Policy non utilizzerà i dati.

Terminiecondizioni

Una pagina relativa a Termini e condizioni da accettare durante il provisioning.

Rappresentazione JSON 
{
  "header": {
    object (UserFacingMessage)
  },
  "content": {
    object (UserFacingMessage)
  }
}
Campi
header

object (UserFacingMessage)

Una breve intestazione che viene visualizzata sopra i contenuti HTML.
content

object (UserFacingMessage)

Una stringa HTML ben formattata. Verrà analizzato sul client con android.text.HTML#fromHTML.

DettagliSignin

Una risorsa contenente i dettagli di accesso per un'azienda. Utilizza enterprises per gestire le SigninDetail per una determinata azienda.

Per un'azienda, possiamo avere un numero qualsiasi di SigninDetail identificati in modo univoco dalla combinazione dei tre campi seguenti (signinUrl, allowPersonalUsage, tokenTag). Non è possibile creare due SigninDetail con lo stesso (signinUrl, allowPersonalUsage, tokenTag). (tokenTag è un campo facoltativo).

Patch: l'operazione aggiorna l'elenco corrente di SigninDetails con il nuovo elenco di SigninDetails.

  • Se la configurazione SigninDetail archiviata viene passata, restituisce gli stessi valori signinEnrollmentToken e qrCode.
  • Se passiamo più configurazioni di SigninDetail identiche che non sono archiviate, la prima configurazione di SigninDetail verrà archiviata.
  • se la configurazione esiste già, non possiamo richiederla più di una volta in una determinata chiamata API patch, altrimenti verrà generato un errore di chiave duplicata e l'intera operazione non andrà a buon fine.
  • Se rimuoviamo dalla richiesta una determinata configurazione di SigninDetail, questa verrà rimossa dallo spazio di archiviazione. Possiamo quindi richiedere altri signinEnrollmentToken e altri qrCode per la stessa configurazione di SigninDetail.
Rappresentazione JSON 
{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "tokenTag": string
}
Campi
signinUrl

string

URL di accesso per l'autenticazione quando viene eseguito il provisioning del dispositivo con un token di registrazione dell'accesso. L'endpoint di accesso dovrebbe completare il flusso di autenticazione con un URL nel formato https://enterprise.google.com/android/register?et= se l'accesso è riuscito o https://enterprise.google.com/android/enroll/invalid se l'accesso non è andato a buon fine.
signinEnrollmentToken

string

Un token di registrazione a livello aziendale utilizzato per attivare il flusso di accesso personalizzato. Si tratta di un campo di sola lettura generato dal server.
qrCode

string

Una stringa JSON la cui rappresentazione UTF-8 può essere utilizzata per generare un codice QR per registrare un dispositivo con questo token di registrazione. Per registrare un dispositivo tramite NFC, il record NFC deve contenere una rappresentazione java.util.Properties serializzata delle proprietà nel JSON. Si tratta di un campo di sola lettura generato dal server.
allowPersonalUsage

enum (AllowPersonalUsage)

Consente di stabilire se è consentito l'utilizzo personale su un dispositivo di cui è stato eseguito il provisioning con questo token di registrazione.

Per i dispositivi di proprietà dell'azienda:

  • L'attivazione dell'utilizzo personale consente all'utente di configurare un profilo di lavoro sul dispositivo.
  • Per disattivare l'utilizzo personale, l'utente deve eseguire il provisioning del dispositivo come dispositivo completamente gestito.

Per i dispositivi di proprietà personale:

  • L'attivazione dell'utilizzo personale consente all'utente di configurare un profilo di lavoro sul dispositivo.
  • La disattivazione dell'utilizzo personale impedirà il provisioning del dispositivo. L'utilizzo personale non può essere disattivato su dispositivi di proprietà personale.
tokenTag

string

Un metadati specificato da EMM per distinguere tra le istanze di SigninDetail.

ContactInfo

Dati di contatto per le aziende della versione gestita di Google Play.

Rappresentazione JSON 
{
  "contactEmail": string,
  "dataProtectionOfficerName": string,
  "dataProtectionOfficerEmail": string,
  "dataProtectionOfficerPhone": string,
  "euRepresentativeName": string,
  "euRepresentativeEmail": string,
  "euRepresentativePhone": string
}
Campi
contactEmail

string

Indirizzo email di un punto di contatto, che verrà utilizzato per inviare annunci importanti relativi alla versione gestita di Google Play.
dataProtectionOfficerName

string

Il nome del responsabile della protezione dei dati.
dataProtectionOfficerEmail

string

L'email del responsabile della protezione dei dati. L'indirizzo email è stato convalidato ma non verificato.
dataProtectionOfficerPhone

string

Numero di telefono del responsabile della protezione dei dati Il numero di telefono è stato convalidato ma non verificato.
euRepresentativeName

string

Il nome del rappresentante UE.
euRepresentativeEmail

string

L'email del rappresentante UE. L'indirizzo email è stato convalidato ma non verificato.
euRepresentativePhone

string

Il numero di telefono del rappresentante UE. Il numero di telefono è stato convalidato ma non verificato.

Metodi

create

 Crea un'azienda.

delete

 Elimina un'azienda.

get

 Sceglie un'azienda.

list

 Elenca le aziende gestite da EMM.

patch

 Aggiorna un'azienda.