Uygulama yükleme ve lisanslamayla ilgili ayrıntıları alma

Bu dokümanda, Google Workspace Marketplace API'ye yapılan istekler ve bu API'den gelen yanıtlarla ilgili örnekler verilerek Google Workspace Marketplace uygulama yükleme ve lisanslama ayrıntılarının nasıl alınacağı gösterilmektedir.

Uygulama, bir yönetici tarafından yüklenmişse

cymbalgroup.com yöneticisi, uygulamayı kuruluştaki herkes için yükledi.

userLicense.get isteği

Bu istek, kullanıcının uygulamayı kullanma izni olup olmadığını belirlemek için [e-mail] kullanıcısının lisanslama durumunu almak üzere userLicense.get yöntemini çağırır.

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

curl -H "Authorization: Bearer {TOKEN}" https://appsmarket.googleapis.com/appsmarket/v2/userLicense/APPLICATION_ID/[e-mail]

Yanıt metni

cymbalgroup.com uygulamayı yüklediğinden yanıt, [e-mail] için userLicense kaynağını döndürür. userLicense kaynağının enabled alanı true olarak ayarlanmıştır. Bu, cymbalgroup.com alan yöneticisinin bu alan için uygulamayı etkinleştirdiğini gösterir. state alanı ise ACTIVE olarak ayarlanmıştır. Bu da [e-mail]'un geçerli bir lisansı olduğunu ve uygulamayı kullanmasına izin verilmesi gerektiğini gösterir.

{
  "kind": "appsmarket#userLicense",
  "enabled": true,
  "state": "ACTIVE",
  "editionId": "default_edition",
  "customerId": "[e-mail]",
  "applicationId": "APPLICATION_ID",
  "id": "USER_LICENSE_ID",
  "userId": "[e-mail]"
}

customerLicense.get isteği

Bu istek, cymbalgroup.com'un lisans durumunu almak için customerLicense.get yöntemini çağırarak uygulamaya erişimlerinin olup olmadığını belirler.

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

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

Yanıt metni

Yanıt, cymbalgroup.com için customerLicense kaynağını döndürür. state alanı ACTIVE olarak ayarlanmıştır. Bu, müşterinin geçerli bir lisansı olduğunu gösterir.

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

Uygulama yalnızca belirli bir kullanıcının kuruluş birimi için yönetici tarafından yüklenmişse

Uygulama artık yalnızca [e-mail] kullanıcısının kuruluş birimi (OU) için yönetici tarafından yükleniyor. Artık kuruluşunuzdaki herkes için yönetici tarafından yüklenemez.

userLicense.get isteği

Bu istek, kullanıcının uygulamayı kullanma izni olup olmadığını belirlemek için [e-mail] kullanıcısının lisanslama durumunu almak üzere userLicense.get yöntemini çağırır.

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

curl -H "Authorization: Bearer {TOKEN}" https://appsmarket.googleapis.com/appsmarket/v2/userLicense/APPLICATION_ID/[e-mail]

Yanıt metni

Uygulama yalnızca [e-mail] için yönetici tarafından yüklendiğinden, yanıtta [e-mail] için enabled alanı false olarak ayarlanmış bir userLicense kaynağı döndürülür. Bu, cymbalgroup.com alan adı yöneticisinin uygulamayı bu alan adı için etkinleştirmediğini gösterir. state alanı ise ACTIVE olarak ayarlanır. Bu da kullanıcının geçerli bir lisansı olduğunu ve uygulamayı kullanmasına izin verilmesi gerektiğini gösterir.

{
  "kind": "appsmarket#userLicense",
  "enabled": false,
  "state": "ACTIVE",
  "editionId": "default_edition",
  "customerId": "cymbalgroup.com",
  "applicationId": "APPLICATION_ID",
  "id": "USER_LICENSE_ID",
  "userId": "[e-mail]"
}

userLicense.get isteği

Bu istek, kullanıcının uygulamayı kullanma izni olup olmadığını belirlemek için [e-mail] kullanıcısının lisanslama durumunu almak üzere userLicense.get yöntemini çağırır.

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

curl -H "Authorization: Bearer {TOKEN}" https://appsmarket.googleapis.com/appsmarket/v2/userLicense/APPLICATION_ID/[e-mail]

Yanıt metni

Uygulama yalnızca [e-mail] için yönetici tarafından yüklendiğinden, yanıtta enabled alanı true, state alanı ise ACTIVE olarak ayarlanmış [e-mail] için userLicense kaynağı döndürülür.

{
  "kind": "appsmarket#userLicense",
  "enabled": true,
  "state": "ACTIVE",
  "editionId": "default_edition",
  "customerId": "cymbalgroup.com",
  "applicationId": "APPLICATION_ID",
  "id": "USER_LICENSE_ID",
  "userId": "[e-mail]"
}

Uygulama, kuruluştaki herkes için silinir.

Uygulama, kuruluştaki herkes için silinmiş olsa da kullanıcı[e-mail], daha önce uygulamayı ayrı ayrı yüklediği için erişime devam edebilir.

userLicense.get isteği

Bu istek, kullanıcının uygulamayı kullanma izni olup olmadığını belirlemek için [e-mail] kullanıcısının lisanslama durumunu almak üzere userLicense.get yöntemini çağırır.

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

curl -H "Authorization: Bearer {TOKEN}" https://appsmarket.googleapis.com/appsmarket/v2/userLicense/APPLICATION_ID/[e-mail]

Yanıt metni

Uygulama kuruluştaki herkes için silindiğinden yanıt, enabled alanı false, state alanı ise UNLICENSED olarak ayarlanmış olan [e-mail] için userLicense kaynağını döndürür. Bu, kullanıcının alanının yöneticisinin, uygulamayı bu kullanıcıya atamadığını gösterir.

{
  "kind": "appsmarket#userLicense",
  "enabled": false,
  "state": "UNLICENSED",
  "applicationId": "APPLICATION_ID",
  "id": "USER_LICENSE_ID",
  "userId": "[e-mail]"
}

userLicense.get isteği

Bu istek, kullanıcının uygulamayı kullanma izni olup olmadığını belirlemek için [e-mail] kullanıcısının lisanslama durumunu almak üzere userLicense.get yöntemini çağırır.

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

curl -H "Authorization: Bearer {TOKEN}" https://appsmarket.googleapis.com/appsmarket/v2/userLicense/APPLICATION_ID/[e-mail]

Yanıt metni

[e-mail], uygulamayı daha önce ayrı olarak yüklediği için uygulamayı kullanmaya devam edebilir. Yanıt, enabled alanı true olarak, state alanı ise ACTIVE olarak ayarlanmış bir userLicense kaynağı döndürür.

{
  "kind": "appsmarket#userLicense",
  "enabled": true,
  "state": "ACTIVE",
  "editionId": "default_edition",
  "customerId": "[e-mail]",
  "applicationId": "APPLICATION_ID",
  "id": "USER_LICENSE_ID",
  "userId": "[e-mail]"
}