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)
  },
  "googleAuthenticationSettings": {
    object (GoogleAuthenticationSettings)
  },
  "enterpriseType": enum (EnterpriseType),
  "managedGooglePlayAccountsEnterpriseType": enum (ManagedGooglePlayAccountsEnterpriseType),
  "managedGoogleDomainType": enum (ManagedGoogleDomainType)
}
Campi
name

string

Il nome dell'impresa 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 vengono pubblicate le notifiche Pub/Sub, nel formato projects/{project}/topics/{topic}. Questo campo è obbligatorio solo se le notifiche Pub/Sub sono attive.
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 del colore vengono 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 visualizzato dagli utenti. Questo campo ha una lunghezza massima di 100 caratteri.
termsAndConditions[]

object (TermsAndConditions)

Termini e condizioni che devono essere accettati durante il provisioning di un dispositivo per questa azienda. Viene generata una pagina di termini per ogni valore di questo elenco.
appAutoApprovalEnabled
(deprecated)

boolean

Ritirato e non utilizzato.
signinDetails[]

object (SigninDetail)

Dettagli di accesso dell'azienda.
contactInfo

object (ContactInfo)

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

object (GoogleAuthenticationSettings)

Impostazioni per l'autenticazione utente fornita da Google.
enterpriseType

enum (EnterpriseType)

Solo output. Il tipo di impresa.
managedGooglePlayAccountsEnterpriseType

enum (ManagedGooglePlayAccountsEnterpriseType)

Solo output. Il tipo di account Google Play gestito per l'azienda.
managedGoogleDomainType

enum (ManagedGoogleDomainType)

Solo output. Il tipo di dominio Google gestito.

NotificationType

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 viene registrato.
COMPLIANCE_REPORT

Deprecato.
STATUS_REPORT Una notifica inviata quando un dispositivo emette un report di stato.
COMMAND Una notifica inviata al termine di un comando del dispositivo.
USAGE_LOGS Una notifica inviata quando il dispositivo invia BatchUsageLogEvents.
ENTERPRISE_UPGRADE Una notifica inviata per un upgrade aziendale. L'upgrade dell'azienda è un processo che esegue l'upgrade di un'azienda con account Google Play gestiti a un dominio Google gestito.

ExternalData

Dati ospitati in una posizione esterna. I dati devono essere scaricati da Android Device Policy e verificati rispetto all'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, pertanto l'URL deve essere accessibile pubblicamente. L'inclusione di un componente lungo e casuale nell'URL può essere utilizzata per impedire agli aggressori di scoprire l'URL.
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.

TermsAndConditions

Una pagina di 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.

SigninDetail

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

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

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

  • Se la configurazione SigninDetail archiviata viene superata, vengono restituiti gli stessi signinEnrollmentToken e qrCode.
  • Se vengono trasmesse più configurazioni SigninDetail identiche non memorizzate, verrà memorizzata la prima tra queste configurazioni SigninDetail.
  • Se la configurazione esiste già, non possiamo richiederla più di una volta in una particolare chiamata API patch, altrimenti verrà generato un errore di chiave duplicata e l'intera operazione non andrà a buon fine.
  • Se rimuoviamo una determinata configurazione SigninDetail dalla richiesta, questa verrà rimossa dallo spazio di archiviazione. A questo punto possiamo richiedere un altro signinEnrollmentToken e qrCode per la stessa configurazione SigninDetail.
Rappresentazione JSON 
{
  "signinUrl": string,
  "signinEnrollmentToken": string,
  "qrCode": string,
  "allowPersonalUsage": enum (AllowPersonalUsage),
  "defaultStatus": enum (SigninDetailDefaultStatus),
  "tokenTag": string
}
Campi
signinUrl

string

URL di accesso per l'autenticazione quando il dispositivo viene sottoposto al provisioning con un token di registrazione per l'accesso. L'endpoint di accesso deve completare il flusso di autenticazione con un URL nel formato https://enterprise.google.com/android/enroll?et= per un accesso riuscito o https://enterprise.google.com/android/enroll/invalid per un accesso non riuscito.
signinEnrollmentToken

string

Un token di registrazione a livello aziendale utilizzato per attivare il flusso di accesso personalizzato. Questo è 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 utilizzando la tecnologia NFC, il record NFC deve contenere una rappresentazione java.util.Properties serializzata delle proprietà nel file JSON. Questo è un campo di sola lettura generato dal server.
allowPersonalUsage

enum (AllowPersonalUsage)

Controlla se l'utilizzo personale è consentito su un dispositivo sottoposto a provisioning con questo token di registrazione.

Per i dispositivi di proprietà aziendale:

  • L'attivazione dell'utilizzo personale consente all'utente di configurare un profilo di lavoro sul dispositivo.
  • La disattivazione dell'utilizzo personale richiede che l'utente esegua 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.
  • Se disattivi l'utilizzo personale, il dispositivo non verrà sottoposto al provisioning. L'utilizzo personale non può essere disattivato su un dispositivo di proprietà personale.
defaultStatus

enum (SigninDetailDefaultStatus)

(Facoltativo) Indica se l'URL di accesso deve essere utilizzato per impostazione predefinita per l'azienda. SigninDetail con defaultStatus impostato su SIGNIN_DETAIL_IS_DEFAULT viene utilizzato per il metodo di registrazione dell'Account Google. Solo uno dei signinDetails di un'azienda può avere defaultStatus impostato su SIGNIN_DETAIL_IS_DEFAULT. Se un Enterprise ha almeno un signinDetails e nessuno di questi ha defaultStatus impostato su SIGNIN_DETAIL_IS_DEFAULT, viene selezionato il primo dall'elenco e defaultStatus viene impostato su SIGNIN_DETAIL_IS_DEFAULT. Se non viene specificato alcun signinDetails per Enterprise, la registrazione del dispositivo con l'Account Google non andrà a buon fine.
tokenTag

string

Metadati specificati dall'EMM per distinguere le istanze di SigninDetail.

SigninDetailDefaultStatus

Indica se l'URL di accesso deve essere utilizzato per impostazione predefinita per l'azienda.

Enum
SIGNIN_DETAIL_DEFAULT_STATUS_UNSPECIFIED Equivalente a SIGNIN_DETAIL_IS_NOT_DEFAULT.
SIGNIN_DETAIL_IS_DEFAULT L'URL di accesso verrà utilizzato per impostazione predefinita per l'azienda.
SIGNIN_DETAIL_IS_NOT_DEFAULT L'URL di accesso non verrà utilizzato per impostazione predefinita per l'azienda.

ContactInfo

Dati di contatto per le aziende con account Google Play gestiti.

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 importanti annunci relativi a Google Play gestito.
dataProtectionOfficerName

string

Il nome del responsabile della protezione dei dati.
dataProtectionOfficerEmail

string

L'email del responsabile della protezione dei dati. L'email è stata convalidata, ma non verificata.
dataProtectionOfficerPhone

string

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

string

Il nome del rappresentante UE.
euRepresentativeEmail

string

L'email del rappresentante UE. L'email è stata convalidata, ma non verificata.
euRepresentativePhone

string

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

GoogleAuthenticationSettings

Contiene le impostazioni per l'autenticazione utente fornita da Google.

Rappresentazione JSON 
{
  "googleAuthenticationRequired": enum (GoogleAuthenticationRequired)
}
Campi
googleAuthenticationRequired

enum (GoogleAuthenticationRequired)

Solo output. Indica se gli utenti devono essere autenticati da Google durante la procedura di registrazione. L'amministratore IT può specificare se l'autenticazione Google è attivata per l'azienda per i dispositivi dei lavoratori della conoscenza. Questo valore può essere impostato solo tramite la Console di amministrazione Google. L'autenticazione Google può essere utilizzata con signinUrl. Nel caso in cui sia richiesta l'autenticazione Google e venga specificato un signinUrl, l'autenticazione Google verrà avviata prima di signinUrl.

GoogleAuthenticationRequired

Impostazione che indica se per questa azienda è richiesta l'autenticazione Google.

Enum
GOOGLE_AUTHENTICATION_REQUIRED_UNSPECIFIED Questo valore non viene utilizzato.
NOT_REQUIRED L'autenticazione Google non è obbligatoria.
REQUIRED L'utente deve essere autenticato correttamente da Google.

EnterpriseType

Il tipo di impresa.

Enum
ENTERPRISE_TYPE_UNSPECIFIED Questo valore non viene utilizzato.
MANAGED_GOOGLE_DOMAIN L'azienda appartiene a un dominio Google gestito.
MANAGED_GOOGLE_PLAY_ACCOUNTS_ENTERPRISE L'azienda è un account Google Play gestito per l'azienda.

ManagedGooglePlayAccountsEnterpriseType

Il tipo di account Google Play gestito per l'azienda.

Enum
MANAGED_GOOGLE_PLAY_ACCOUNTS_ENTERPRISE_TYPE_UNSPECIFIED Il tipo di account Google Play gestiti per l'azienda non è specificato.
CUSTOMER_MANAGED L'azienda è gestita dal cliente
EMM_MANAGED L'azienda è gestita da EMM (deprecato).

ManagedGoogleDomainType

Il tipo di dominio Google gestito.

Enum
MANAGED_GOOGLE_DOMAIN_TYPE_UNSPECIFIED Il tipo di dominio Google gestito non è specificato.
TYPE_TEAM Il dominio Google gestito è un team con indirizzo email verificato.
TYPE_DOMAIN Il dominio Google gestito è stato verificato.

Metodi

create

 Crea un'azienda.

delete

 Elimina definitivamente un'azienda e tutti gli account e i dati associati.

generateEnterpriseUpgradeUrl

 Genera un URL di upgrade dell'azienda per eseguire l'upgrade di un'azienda con account Google Play gestiti esistente a un dominio Google gestito.

get

 Ottiene un'impresa.

list

 Elenca le aziende gestite da EMM.

patch

 Aggiorna un'organizzazione.