Ricevi dettagli sull'installazione e sulle licenze dell'app

Fornendo richieste ed esempi di risposte dell' API Google Workspace Marketplace, questo documento mostra come ottenere i dettagli di installazione e licenza delle app di Google Workspace Marketplace.

L'applicazione è installata da un amministratore

L'amministratore di cymbalgroup.com ha installato l'applicazione per tutti gli utenti dell'organizzazione.

Richiesta userLicense.get

Questa richiesta chiama il metodo userLicense.get per ottenere lo stato della licenza dell'utente user1@cymbalgroup.com per determinare se dispone dell'autorizzazione per utilizzare l'applicazione.

GET /appsmarket/v2/userLicense/{applicationId}/{userId}

curl -H "Authorization: Bearer {TOKEN}" https://appsmarket.googleapis.com/appsmarket/v2/userLicense/APPLICATION_ID/user1@cymbalgroup.com

Corpo della risposta

Poiché cymbalgroup.com ha installato l'applicazione, la risposta restituisce la risorsa userLicense per user1@cymbalgroup.com. La risorsa userLicense ha il campo enabled impostato su true, a indicare che l'amministratore di dominio per cymbalgroup.com ha attivato l'applicazione per questo dominio e il campo state impostato su ACTIVE, a indicare che user1@cymbalgroup.com ha una licenza valida e deve essere autorizzato a utilizzare l'applicazione.

{
  "kind": "appsmarket#userLicense",
  "enabled": true,
  "state": "ACTIVE",
  "editionId": "default_edition",
  "customerId": "user1@cymbalgroup.com",
  "applicationId": "APPLICATION_ID",
  "id": "USER_LICENSE_ID",
  "userId": "user1@cymbalgroup.com"
}

Richiesta customerLicense.get

Questa richiesta chiama il metodo customerLicense.get per ottenere lo stato della licenza di cymbalgroup.com per determinare se ha accesso all'applicazione.

GET /appsmarket/v2/customerLicense/{applicationId}/{customerId}

curl -H "Authorization: Bearer {TOKEN}" https://appsmarket.googleapis.com/appsmarket/v2/customerLicense/APPLICATION_ID/cymbalgroup.com

Corpo della risposta

La risposta restituisce la risorsa customerLicense per cymbalgroup.com dove il campo state è impostato su ACTIVE, a indicare che il cliente dispone di una licenza valida.

{
  "kind": "appsmarket#customerLicense",
  "id": "CUSTOMER_LICENSE_ID",
  "applicationId": "APPLICATION_ID",
  "customerId": "cymbalgroup.com",
  "state": "ACTIVE",
  "editions": [
    {
      "editionId": "default_edition",
      "seatCount": -1
    }
  ]
}

L'applicazione è installata solo dall'amministratore per l'unità organizzativa di un utente specifico

L'applicazione ora è installata solo dall'amministratore per l'unità organizzativa (UO) dell'utente user2@cymbalgroup.com. Non è più installato dall'amministratore per tutti gli utenti dell'organizzazione.

Richiesta userLicense.get

Questa richiesta chiama il metodo userLicense.get per ottenere lo stato della licenza dell'utente user3@cymbalgroup.com per determinare se ha l'autorizzazione a utilizzare l'applicazione.

GET /appsmarket/v2/userLicense/{applicationId}/{userId}

curl -H "Authorization: Bearer {TOKEN}" https://appsmarket.googleapis.com/appsmarket/v2/userLicense/APPLICATION_ID/user3@cymbalgroup.com

Corpo della risposta

Poiché l'applicazione è installata solo dall'amministratore per user2@cymbalgroup.com, la risposta restituisce una risorsa userLicense per user3@cymbalgroup.com con il campo enabled impostato su false, a indicare che l'amministratore di dominio per cymbalgroup.com non ha attivato l'applicazione per questo dominio e il campo state impostato su ACTIVE, a indicare che l'utente ha una licenza valida e deve essere autorizzato a utilizzare l'applicazione.

{
  "kind": "appsmarket#userLicense",
  "enabled": false,
  "state": "ACTIVE",
  "editionId": "default_edition",
  "customerId": "cymbalgroup.com",
  "applicationId": "APPLICATION_ID",
  "id": "USER_LICENSE_ID",
  "userId": "user3@cymbalgroup.com"
}

Richiesta userLicense.get

Questa richiesta chiama il metodo userLicense.get per ottenere lo stato della licenza dell'utente user2@cymbalgroup.com per determinare se dispone dell'autorizzazione per utilizzare l'applicazione.

GET /appsmarket/v2/userLicense/{applicationId}/{userId}

curl -H "Authorization: Bearer {TOKEN}" https://appsmarket.googleapis.com/appsmarket/v2/userLicense/APPLICATION_ID/user2@cymbalgroup.com

Corpo della risposta

Poiché l'applicazione è installata solo dall'amministratore per user2@cymbalgroup.com, la risposta restituisce una risorsa userLicense per user2@cymbalgroup.com con il campo enabled impostato su true e il campo state impostato su ACTIVE.

{
  "kind": "appsmarket#userLicense",
  "enabled": true,
  "state": "ACTIVE",
  "editionId": "default_edition",
  "customerId": "cymbalgroup.com",
  "applicationId": "APPLICATION_ID",
  "id": "USER_LICENSE_ID",
  "userId": "user2@cymbalgroup.com"
}

L'applicazione viene eliminata per tutti gli utenti dell'organizzazione

Anche se l'applicazione è stata eliminata per tutti gli utenti dell'organizzazione, user1@cymbalgroup.com ha ancora accesso perché l'aveva installata singolarmente.

Richiesta userLicense.get

Questa richiesta chiama il metodo userLicense.get per ottenere lo stato della licenza dell'utente user2@cymbalgroup.com per determinare se dispone dell'autorizzazione per utilizzare l'applicazione.

GET /appsmarket/v2/userLicense/{applicationId}/{userId}

curl -H "Authorization: Bearer {TOKEN}" https://appsmarket.googleapis.com/appsmarket/v2/userLicense/APPLICATION_ID/user2@cymbalgroup.com

Corpo della risposta

Poiché l'applicazione è stata eliminata per tutti gli utenti dell'organizzazione, la risposta restituisce una risorsa userLicense per user2@cymbalgroup.com con il campo enabled impostato su false e il campo state impostato su UNLICENSED, a indicare che l'amministratore del dominio di questo utente non ha assegnato un posto per l'applicazione a questo utente.

{
  "kind": "appsmarket#userLicense",
  "enabled": false,
  "state": "UNLICENSED",
  "applicationId": "APPLICATION_ID",
  "id": "USER_LICENSE_ID",
  "userId": "user2@cymbalgroup.com"
}

Richiesta userLicense.get

Questa richiesta chiama il metodo userLicense.get per ottenere lo stato della licenza dell'utente user1@cymbalgroup.com per determinare se ha l'autorizzazione a utilizzare l'applicazione.

GET /appsmarket/v2/userLicense/{applicationId}/{userId}

curl -H "Authorization: Bearer {TOKEN}" https://appsmarket.googleapis.com/appsmarket/v2/userLicense/APPLICATION_ID/user1@cymbalgroup.com

Corpo della risposta

Poiché user1@cymbalgroup.com ha installato l'applicazione singolarmente in precedenza, ha ancora l'autorizzazione per utilizzarla. La risposta restituisce una risorsa userLicense con il campo enabled impostato su true e il campo state impostato su ACTIVE.

{
  "kind": "appsmarket#userLicense",
  "enabled": true,
  "state": "ACTIVE",
  "editionId": "default_edition",
  "customerId": "user1@cymbalgroup.com",
  "applicationId": "APPLICATION_ID",
  "id": "USER_LICENSE_ID",
  "userId": "user1@cymbalgroup.com"
}