Mendapatkan detail penginstalan dan pemberian lisensi aplikasi

Dengan memberikan contoh permintaan ke dan respons dari Google Workspace Marketplace API, dokumen ini menunjukkan cara mendapatkan detail penginstalan dan pemberian lisensi aplikasi Google Workspace Marketplace.

Aplikasi diinstal oleh administrator

Administrator cymbalgroup.com menginstal aplikasi untuk semua orang di organisasi.

Permintaan userLicense.get

Permintaan ini memanggil metode userLicense.get untuk mendapatkan status pemberian lisensi user1@cymbalgroup.com guna menentukan apakah mereka memiliki izin untuk menggunakan aplikasi.

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

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

Isi respons

Karena cymbalgroup.com telah menginstal aplikasi, respons akan menampilkan resource userLicense untuk user1@cymbalgroup.com. Resource userLicense memiliki kolom enabled yang ditetapkan ke true, yang menunjukkan bahwa administrator domain untuk cymbalgroup.com telah mengaktifkan aplikasi untuk domain ini, dan kolom state ditetapkan ke ACTIVE, yang menunjukkan bahwa user1@cymbalgroup.com memiliki lisensi yang valid dan harus diizinkan untuk menggunakan aplikasi.

{
  "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"
}

Permintaan customerLicense.get

Permintaan ini memanggil metode customerLicense.get untuk mendapatkan status pemberian lisensi cymbalgroup.com guna menentukan apakah mereka memiliki akses ke aplikasi.

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

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

Isi respons

Respons menampilkan resource customerLicense untuk cymbalgroup.com dengan kolom state disetel ke ACTIVE, yang menunjukkan bahwa pelanggan memiliki lisensi yang valid.

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

Aplikasi hanya diinstal oleh administrator untuk unit organisasi pengguna tertentu

Aplikasi kini hanya diinstal oleh administrator untuk unit organisasi (OU) user2@cymbalgroup.com. Aplikasi ini tidak lagi diinstal oleh administrator untuk semua orang di organisasi.

Permintaan userLicense.get

Permintaan ini memanggil metode userLicense.get untuk mendapatkan status pemberian lisensi pengguna3@cymbalgroup.com guna menentukan apakah mereka memiliki izin untuk menggunakan aplikasi.

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

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

Isi respons

Karena aplikasi hanya diinstal oleh administrator untuk user2@cymbalgroup.com, respons menampilkan resource userLicense untuk user3@cymbalgroup.com yang memiliki kolom enabled yang disetel ke false, yang menunjukkan bahwa administrator domain untuk cymbalgroup.com belum mengaktifkan aplikasi untuk domain ini, dan kolom state yang disetel ke ACTIVE, yang menunjukkan bahwa pengguna memiliki lisensi yang valid dan harus diizinkan untuk menggunakan aplikasi.

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

Permintaan userLicense.get

Permintaan ini memanggil metode userLicense.get untuk mendapatkan status pemberian lisensi user2@cymbalgroup.com guna menentukan apakah mereka memiliki izin untuk menggunakan aplikasi.

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

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

Isi respons

Karena aplikasi hanya diinstal oleh administrator untuk user2@cymbalgroup.com, respons menampilkan resource userLicense untuk user2@cymbalgroup.com yang memiliki kolom enabled yang disetel ke true dan kolom state yang disetel ke 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"
}

Aplikasi dihapus untuk semua orang di organisasi

Meskipun aplikasi telah dihapus untuk semua orang di organisasi, user1@cymbalgroup.com masih memiliki akses karena sebelumnya menginstal aplikasi tersebut secara individual.

Permintaan userLicense.get

Permintaan ini memanggil metode userLicense.get untuk mendapatkan status pemberian lisensi user2@cymbalgroup.com guna menentukan apakah mereka memiliki izin untuk menggunakan aplikasi.

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

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

Isi respons

Karena aplikasi dihapus untuk semua orang di organisasi, respons akan menampilkan resource userLicense untuk user2@cymbalgroup.com yang memiliki kolom enabled yang ditetapkan ke false dan kolom state yang ditetapkan ke UNLICENSED, yang menunjukkan bahwa administrator domain pengguna ini tidak menetapkan kursi untuk aplikasi kepada pengguna ini.

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

Permintaan userLicense.get

Permintaan ini memanggil metode userLicense.get untuk mendapatkan status pemberian lisensi user1@cymbalgroup.com guna menentukan apakah mereka memiliki izin untuk menggunakan aplikasi.

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

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

Isi respons

Karena user1@cymbalgroup.com sebelumnya menginstal aplikasi secara terpisah, dia tetap memiliki izin untuk menggunakannya. Respons menampilkan resource userLicense yang memiliki kolom enabled yang ditetapkan ke true dan kolom state yang ditetapkan ke 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"
}