---
title: Android-hallinta-API
slug: nmdm/admin-guide/fi/vnow/android-hallinta-api
createdAt: 2026-09-24T15:27:30.000Z
---

Android-hallinta-API (AMAPI) on Googlen pilvikäyttöympäristön API, joka integroi Google Android UEM -toiminnot palveluun Ivanti Neurons for MDM. Android-hallinta-API-kehys voidaan ottaa käyttöön Android Enterprise -määrityksissä, jotta Android Enterprise -laitteita voidaan hallita ilman että asiakassovellusta tarvitsee asentaa laitteisiin laitehallintaa varten. Tällä hetkellä kohteen Go app lähettämistä laitteelle ei tueta muita toimintoja, kuten MTD\:tä varten.

Kun Android Enterprise -tili on määritetty asetuksissa, voit ottaa käyttöön Android-hallinta-API-kehyksen ja käyttää sitä. Käyttöönoton jälkeen seuraavat toimenpiteet ovat mahdollisia:

- Voit lisätä rekisteröintiprofiilin, jotta voit käyttää QR-koodia laiterekisteröintiin.
- Voit luoda erillisen laitemäärityksen (yrityksen omistama kertakäyttöinen eli COSU) rekisteröidylle laitteelle tiettyä tarkoitusta varten.

Android-hallinta-API\:tä tuetaan tällä hetkellä vain laitteissa, joissa on Android 9 tai uudempi, joihin on asennettu Google Play ja jotka on otettu käyttöön Erillinen-tilassa. Yrityksen omistama erillinen laite -tilasta käytetään myös nimitystä Yrityksen omistama kertakäyttöinen (COSU) -tila, ja se on eräs laitteen omistaja -tilan muoto. Tämä toiminto tukee myös seuraavia laitetoimintoja:

- Lukitus
- Uudelleenkäynnistys
- Synkronointi palvelimelle
- Pyyhi

Laitteet on ajastettu kirjautumaan sisään säännöllisin väliajoin (tunneittain). Jos se kuitenkin halutaan tehdä välittömästi, käytä laitteen Synkronointi palvelimelle -toimintoa Laitteen tiedot -sivulla. AMAPI-laitteet eivät lähetä pakollisia sisäänkirjautumisia palveluun Ivanti Neurons for MDM. Inventaariopäivitykset suoritetaan silloin kun laitteessa on toiminto meneillään.

## Android-hallinta-API\:n käyttöönotto

Voit ottaa käyttöön Android-hallinta-API\:n valitsemalla **Hallinto > Android Enterprise > Valtuuta Google (edellyttää kelvollisen Google-osoitteen) > Android Enterprise -tuettu**.

Käyttöönotetun Android-hallinta-API-ominaisuuden tila (**Kyllä**, jos käytössä, ja **Ei**, jos pois käytöstä) näytetään myös Laitteen tiedot -sivulla.

:::hint{type="info"}
GSuite-tilejä ei tueta tällä hetkellä COSU-määrityksessä.
:::

## Rekisteröintiprofiilin lisääminen

Rekisteröintiprofiili tarvitaan, jotta Android-laite voidaan rekisteröidä käyttämällä tunnuksen QR-koodin lukua tai aakkosnumeerista merkkijonoa. Rekisteröintiprofiileja voidaan luoda vain kun Android-hallinta-API on käytössä. Voit myös luoda mukautettuja laiteominaisuuksia, jotka liitetään rekisteröintiprofiiliin.

1. Valitse **Hallinto > Android Enterprise > Rekisteröintiprofiilit**.
2. Määritä seuraavat asetukset **Rekisteröintiprofiili – yrityksen omistama erillinen laite** -ikkunassa.
3. Napsauta **Tallenna**. **Profiilin yhteenveto** -ikkunassa on seuraavat tunnuksen tiedot:

| **Asetus**                       | **Kuvaus**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nimi**-kenttään                | Anna rekisteröintiprofiilille nimi.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| **Kuvaus**                       | Anna kuvaus, jossa kerrotaan tämän rekisteröintiprofiilin tarkoitus.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| **Käyttäjänimi**                 | Anna kelvollisen käyttäjänimen ensimmäiset kirjaimet ja valitse sopiva näkyviin tulevista tuloksista.<br />Kelvollinen käyttäjänimi voi olla paikallisen tai LDAP-käyttäjän.<br />Rekisteröintiprofiilit merkitsevät profiilin QR-koodilla rekisteröidyt laitteet siten, että ne näytetään laitteina, jotka kuuluvat käyttäjälle, jolle rekisteröintiprofiili luotiin.                                                                                                                                                                                                                                                                                  |
| **Tunnuksen voimassaolo**        | Määritä, kuinka monta päivää todennustunnuksen QR-koodin luku on voimassa. Arvon tulee olla 1–30. Laite nollataan, jos käytät vanhentunutta tunnusta tai rekisteröintiprofiilia.                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **Mukautetut laiteominaisuudet** | Voit lisätä rekisteröintiprofiiliin liitettäviä mukautettuja laiteominaisuuksia napsauttamalla Toiminnot-sarakkeessa **+Lisää uusi**.<br />1. Valitse mukautettu laiteominaisuus **Ominaisuuden nimi** -sarakkeen avattavasta luettelosta.<br />2. Kirjoita mukautetun ominaisuuden arvo **Arvo**-sarakkeeseen.<br />3. Napsauta **Tallenna**. Lisätty mukautettu laiteominaisuus näytetään taulukossa. Voit poistaa sen napsauttamalla **Poista**-vaihtoehtoa Toiminnot-sarakkeessa.<br />Mukautetut ominaisuudet voidaan lisätä rekisteröintiprofiiliin vain profiilin luonnin aikana. Ominaisuuskenttiä ei voida muokata profiilin luomisen jälkeen. |

- Nimi
- Kuvaus
- Käyttäjänimi
- Tunnuksen luontipäivä
- Tunnuksen vanhenemispäivä
- Tunnuksen arvo
- QR-koodi
- Mukautetut laiteominaisuudet.

:::hint{type="info"}
Laitteet nollataan, jos laitteen asianmukaista määritystä ei haeta 10 minuutin sisällä rekisteröitymisestä. Tällaisissa tapauksissa rekisteröinti tulee tehdä uudelleen käyttämällä rekisteröintitunnusta/QR-koodia.
:::

Kun rekisteröintiprofiili on luotu, se näkyy **Rekisteröintiprofiilit**-sivulla. Voit suorittaa jonkin seuraavista toiminnoista **Toiminnot**-sarakkeessa.

- Voit tarkastella rekisteröintiprofiilin tietoja Profiilin yhteenveto -ikkunassa napsauttamalla Näytä-kuvaketta. Myös QR-koodi näkyy tässä ikkunassa.
- Voit muokata rekisteröintiprofiilin tietoja napsauttamalla Muokkaa-kuvaketta.

:::hint{type="info"}
Voit muokata vain tunnuksen voimassaoloa. Muita ominaisuuksia ei voida muokata.
:::

Voit poistaa rekisteröintiprofiilin napsauttamalla Muokkaa-kuvaketta.

## COSU-määrityksen luominen

Järjestelmänvalvojat voivat määrittää Android Enterprisessä erillisiä laitteita, joita voidaan käyttää tiettyyn tarkoitukseen, käyttämällä Erilliset laitteet -määritystä (yrityksen omistama kertakäyttöinen eli COSU). COSU-määritys jaellaan työpaikan hallitsemiin laitteisiin (laitteen omistaja -tila), jotta vain yksi sovellus on käyttäjien käytettävissä kioskitilassa. Laitteita, jotka ovat työprofiili yrityksen omistamassa laitteessa -tilassa, ei tueta.

Käyttämällä tätä määritystä järjestelmänvalvoja voi määrittää laitteet siten, että sovellus on kiinnitetty näyttöön. Kioskitilan käyttäjä ei voi poistaa sovelluksen kiinnitystä ja siirtyä pois sovelluksesta muihin laitteen näyttöihin tai käyttää muuta sovellusta laitteessa.

:::hint{type="info"}
Myös muiden sovellusten asennus AMA-laitteeseen voidaan pakottaa valitsemalla Asenna laitteeseen -vaihtoehto Lisäasetukset ja sovellusmääritykset -osiosta. Niitä ei kuitenkaan voi käyttää, kun kioskisovellus on kiinnitetty näyttöön määrityksen kautta. Monen sovelluksen kioskin osalta on suositeltavaa käyttää Työpaikan hallitsema laite (laitteen omistaja) -tilan kioskitoimintoa. Näin sovelluksia ja laitteen asetuksia voidaan hallita tehokkaammin, ja se voidaan myös laajentaa monen käyttäjän tilaan.
:::

Järjestelmänvalvojat voivat tehdä määritysmuutoksia, kuten sallia loppukäyttäjälle järjestelmässä navigoinnin sekä mahdollisuuden käyttää muita laitteeseen lähetettyjä sovelluksia. Tämä voidaan tehdä käymällä tarvittavat vaihtoehdot läpi Google DPC\:ssä.

COSU-määritykset määräytyvät niille annetun prioriteetin mukaisesti. Käytäntömäärityksen lähettämiseen Googlelle käytetään korkeimman prioriteetin määritystä. COSU-määritykset otetaan käyttöön laitteissa määritetyn tilan sisällä. Se voidaan delegoida muihin tiloihin, jos se on määritetty oletustilassa.

Määrittäminen:

1. Valitse **Määritys > +Lisää**.
2. Napsauta **Lukitus ja kioski: Android Enterprise -määrityksessä** **Erilliset laitteet (yrityksen omistama kertakäyttöinen eli COSU)**.
3. Kirjoita määritykselle annettava nimi.
4. Kirjoita kuvaus.
5. Voit määrittää seuraavat asetukset napsauttamalla soveltuvaa välilehteä:

- **Sovellusasetukset**
- **Yleiset lukitukset**
- **Kioskin mukautus**
- **Järjestelmäasetukset**

Seuraavassa taulukossa on määritettävissä olevien kenttien tiedot:

| **Asetus**                               | **Kuvaus**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Sovellusasetus**                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Sovelluksen nimi**                     | Valitse laitteeseen kiinnitettävä sovellus aloittamalla kirjoittamaan sovelluksen nimeä, kunnes haluttu sovellus näkyy avattavassa luettelossa. Jos haluttua sovellusta ei näy avattavassa valikossa, varmista, että käyttöön otettava sovellus on Play Storessa saatavilla oleva julkinen/yksityinen sovellus ja että se on lisätty App Catalogiin.<br />Tämä kenttä on pakollinen. Määritystä ei voida luoda, jos tähän kenttään lisättävää sovellusta ei valita. Voit lisätä vain julkisia ja yksityisiä sovelluksia. Omia sovelluksia ja verkkosovelluksia (yksityisiä) ei voida lisätä.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **Yleiset lukitukset**                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Pidä näyttö päällä**                   | Määritä akku kytketty -tilat, joissa laite pysyy päällä. Valitse jokin seuraavista vaihtoehdoista:<br />- **Verkkovirta** – virtalähde on verkkovirtalaturi<br />- **Langaton**<br />- **USB** – virtalähde on USB-portti<br />- **Mikä tahansa** – virtalähde on verkkovirtalaturi, USB-portti tai langaton laturi.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **Kioskin mukautus**                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Mukauta tilapalkki**                   | Mukauta kohdelaitteiden tilapalkki valitsemalla jokin seuraavista vaihtoehdoista:<br />- **Ilmoitukset ja järjestelmätiedot käytössä** – Järjestelmätiedot ja ilmoitukset näytetään tilapalkissa.<br />- **Vain järjestelmätiedot käytössä** – Vain järjestelmätiedot näytetään tilapalkissa.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| **Mukauta järjestelmän navigointi**      | Määritä navigointitoimintojen (Koti- ja Yhteenveto-painikkeet) käyttöoikeus kioskitilassa valitsemalla jokin seuraavista vaihtoehdoista.<br />- **Käytössä** – Sallii navigoinnin Koti- ja Yhteenveto-painikkeilla. Käyttäjät voivat poistua määritetystä sovelluksesta, jos tämä vaihtoehto on valittuna.<br />- **Pois käytöstä** – Poistaa käytöstä navigoinnin Koti- ja Yhteenveto-painikkeilla.<br />- **Vain Koti-painike** – Sallii navigoinnin vain Koti-painikkeella.<br />Takaisin-painike on käytettävissä kaikissa näissä vaihtoehdoissa.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| **Salli yleiset toiminnot**              | Valitse tämä, jos haluat sallia yleiset toiminnot kioskitilassa. Virtapainikkeisiin liittyvää uudelleenkäynnistys- ja sammutustoimintaa hallitaan tällä asetuksella.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| **Salli järjestelmävirhevalintaikkunat** | Valitse tämä, jos haluat sallia kaatuneiden tai vastaamattomien sovellusten virhevalintaikkunat kioskitilassa.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Järjestelmäasetukset**                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **Järjestelmäpäivitysasetukset**         | Määritä seuraavat järjestelmäpäivityksiä koskevat asetukset:<br />- **Järjestelmäpäivitys** – Valitse vaaditun järjestelmäpäivityksen tyyppi.<br />- **Automaattinen** – Asenna automaattisesti heti kun päivitys on saatavilla.<br />- **Lykkää** – Lykkää automaattista asennusta enintään 30 päivää.<br />- **Ikkunoitu** – Asenna automaattisesti päivittäisen ylläpitoikkunan sisällä. Aseta ylläpitoikkunan alkamis- ja päättymisaika.<br />Laitteisiin asennettavat päivitykset saattavat vaihdella tuettujen ominaisuuksien, Android-version ja laitteeseen asennetun Google DPC -version perusteella.<br />- **Jäädytysjakso** – Kun laite on asetettu jäädytysjaksolle, kaikki saapuvat järjestelmäpäivitykset estetään eikä niitä asenneta. Aseta jäädytysjakson **alkamispäivä** ja **päättymispäivä** napsauttamalla **Lisää jäädytysjakso**.<br />Jos laite on jäädytysjakson ulkopuolella, käytössä on normaali päivitystoiminta. Jos päättymispäivä on ennen alkamispäivää, jäädytysjaksoa jatketaan seuraavalle vuodelle.<br />Jäädytysjakson pituus voi olla enintään 90 päivää. Kahden peräkkäisen jäädytysjakson välillä tulee olla vähintään 60 päivää. |

6. Napsauta **Seuraava**.
7. Valitse jokin seuraavista jakeluvaihtoehdoista:

- **Kaikki laitteet**
- **Ei laitteita** (oletus)
- **Mukautettu**

8. Napsauta **Valmis**.

### AMAPI-laitteiden sovellusten hallinta

Kun COSU-määritys jaellaan laitteisiin, sovellukset lähetetään AMA-laitteeseen ja kiinnitetään sen näyttöön. AMA-laitteeseen asennettuja sovelluksia voidaan edelleen hallita riippumatta laitteeseen lähetetystä COSU-määrityksestä. Seuraavassa on tiedot sovellushallinnasta näissä laitteissa:

- Julkisia ja yleisiä sovelluksia tuetaan, omia sovelluksia ja verkkoleikkeitä ei.
- Sovelluksia lähetetään vain jos asennusasetuksissa on käytössä Asenna laitteeseen- tai Asennus taustalla -valinta. Jos sovelluksia osoitetaan käyttäjälle/laitteeseen ilman että jompikumpi näistä valinnoista on käytössä, niitä ei näy laitteessa tai laitteen Play Storessa, eikä käyttäjä voi suorittaa niille toimenpiteitä.
- Tuetut sovellusmääritykset ovat Hallittu Google Play ja Työpaikan hallitsema laite (Android for Work) -asetukset. Sovellusten hallittuja määrityksiä tuetaan, mukaan lukien OEMConfig-sovellusten hallitun määrityksen tuki.

:::hint{type="info"}
Määritysten asennusten suorituksen ja asennuksen poistamisen aika voi vaihdella Googlen (viestipalvelu) ilmoitusten perusteella riippuen siitä, suoritetaanko haluttu toiminto.
:::

- Go app asennetaan nyt oletuksena osana AMA-laitteen rekisteröintiä. Sovellus kiinnitetään näytölle rekisteröintiprosessin aikana. Kun määritys on suoritettu, sovellus suoritetaan taustalla.

:::hint{type="info"}
Käytäntöjä ei tueta lukuun ottamatta laitteen rekisteröintivaatimuksen täytäntöönpanoa, joka riippuu valmistajasta, käyttöjärjestelmäversiosta ja tietoturvakorjauksen tasosta. Laitteiden lisääminen sallittujen listalle, joka sallii vain sallittujen listalla olevien laitteiden rekisteröinnin palveluun Ivanti Neurons for MDM, on tuettu.
:::

### AMAPI-laitteiden sovellusten palautetuen hallinta

AMAPI (COSU) -laitteiden sovelluspalautteen tukea voidaan hallita. Kun laite rekisteröidään AMAPI (COSU) -tilassa, hallittu sovellusmääritys lähetetään suoraan palveluun Ivanti Neurons for MDM Googlesta ilman palvelun Go app suorittamia toimenpiteitä. Hallitun sovelluspalautteen tietoja voidaan tarkastella laitetasolla kohdasta **Laitteen tiedot > Asennetut sovellukset > Näytä palaute** tai yksittäisen sovelluksen tasolla siirtymällä tiettyyn Android-sovellukseen sovellusluettelon Sovellusmäärityspalaute-välilehdellä kaikkien laitteiden yleisen raportin kohdalla. Tietoja sovelluksen palautemenetelmästä on kohdassa [Sovelluspalautteen synkronointi ja hakeminen](docId\:GGf99WojYmFcy4GHXQCCQ).

### AMAPI\:n rajoitukset

AMAPI\:n rajoitukset ovat tällä hetkellä seuraavat:

- Vain erillisiä laitteita (COSU-tila) tuetaan.

### Tuetut määritykset

Seuraavia määrityksiä tuetaan AMAPI\:n osalta:

- Sovellusten jakelu (yksittäiset tai useat sovellukset)
- Hallittu sovellus -määritys laitteeseen lähetetyille sovelluksille
- Wi-Fi-määritys
- Android Enterprise -lockdown-erillismääritys (COSU)
- Always On VPN -määritys
