ऐप्लिकेशन को इंस्टॉल करने और लाइसेंस देने की जानकारी पाएं

इस दस्तावेज़ में, Google Workspace Marketplace API को भेजे गए अनुरोधों और उससे मिले जवाबों के उदाहरण दिए गए हैं. इससे यह पता चलता है कि Google Workspace Marketplace से ऐप्लिकेशन इंस्टॉल करने और लाइसेंसिंग की जानकारी कैसे पाई जाती है.

इस ऐप्लिकेशन को एडमिन ने इंस्टॉल किया है

cymbalgroup.com के एडमिन ने संगठन के सभी लोगों के लिए ऐप्लिकेशन इंस्टॉल किया है.

userLicense.get अनुरोध

इस अनुरोध में, userLicense.get तरीके का इस्तेमाल किया गया है. इससे user1@cymbalgroup.com के लाइसेंस की स्थिति का पता चलता है. इससे यह तय किया जाता है कि उसके पास ऐप्लिकेशन इस्तेमाल करने की अनुमति है या नहीं.

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

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

जवाब का मुख्य भाग

cymbalgroup.com ने ऐप्लिकेशन इंस्टॉल किया है. इसलिए, जवाब में user1@cymbalgroup.com के लिए userLicense रिसॉर्स दिखता है. userLicense रिसॉर्स में enabled फ़ील्ड को true पर सेट किया गया है. इससे पता चलता है कि cymbalgroup.com के डोमेन एडमिन ने इस डोमेन के लिए ऐप्लिकेशन चालू कर दिया है. साथ ही, state फ़ील्ड को ACTIVE पर सेट किया गया है. इससे पता चलता है कि user1@cymbalgroup.com के पास मान्य लाइसेंस है और उसे ऐप्लिकेशन इस्तेमाल करने की अनुमति दी जानी चाहिए.

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

customerLicense.get अनुरोध

इस अनुरोध में customerLicense.get तरीके का इस्तेमाल किया जाता है. इससे cymbalgroup.com के लाइसेंसिंग स्टेटस का पता चलता है. इससे यह तय किया जाता है कि उनके पास ऐप्लिकेशन का ऐक्सेस है या नहीं.

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

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

जवाब का मुख्य भाग

जवाब में, cymbalgroup.com के लिए customerLicense संसाधन दिखाया गया है. इसमें state फ़ील्ड को ACTIVE पर सेट किया गया है. इससे पता चलता है कि खरीदार के पास मान्य लाइसेंस है.

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

ऐप्लिकेशन को सिर्फ़ एडमिन ने किसी उपयोगकर्ता की संगठनात्मक इकाई के लिए इंस्टॉल किया हो

अब यह ऐप्लिकेशन, सिर्फ़ उपयोगकर्ता2@cymbalgroup.com के संगठन की इकाई (ओयू) के लिए एडमिन ने इंस्टॉल किया है. अब यह ऐप्लिकेशन, संगठन के सभी लोगों के लिए एडमिन की ओर से इंस्टॉल नहीं किया जाता.

userLicense.get अनुरोध

इस अनुरोध में, userLicense.get तरीके का इस्तेमाल किया गया है. इससे user3@cymbalgroup.com के लाइसेंस की स्थिति का पता चलता है. इससे यह तय किया जाता है कि उपयोगकर्ता के पास ऐप्लिकेशन इस्तेमाल करने की अनुमति है या नहीं.

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

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

जवाब का मुख्य भाग

ऐप्लिकेशन को सिर्फ़ user2@cymbalgroup.com के लिए एडमिन ने इंस्टॉल किया है. इसलिए, जवाब में user3@cymbalgroup.com के लिए userLicense संसाधन मिलता है. इसमें enabled फ़ील्ड को false पर सेट किया गया है. इसका मतलब है कि cymbalgroup.com के डोमेन एडमिन ने इस डोमेन के लिए ऐप्लिकेशन को चालू नहीं किया है. साथ ही, state फ़ील्ड को ACTIVE पर सेट किया गया है. इसका मतलब है कि उपयोगकर्ता के पास मान्य लाइसेंस है और उसे ऐप्लिकेशन इस्तेमाल करने की अनुमति दी जानी चाहिए.

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

userLicense.get अनुरोध

इस अनुरोध में, userLicense.get तरीके का इस्तेमाल किया गया है. इससे user2@cymbalgroup.com के लाइसेंस का स्टेटस पता चलता है. इससे यह तय किया जा सकता है कि उसके पास ऐप्लिकेशन इस्तेमाल करने की अनुमति है या नहीं.

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

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

जवाब का मुख्य भाग

ऐप्लिकेशन को सिर्फ़ administrator ने user2@cymbalgroup.com के लिए इंस्टॉल किया है. इसलिए, जवाब में user2@cymbalgroup.com के लिए userLicense रिसॉर्स दिखता है. इसमें enabled फ़ील्ड को true पर और state फ़ील्ड को 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"
}

संगठन में शामिल सभी लोगों के लिए, ऐप्लिकेशन मिटा दिया जाता है

संगठन के सभी लोगों के लिए ऐप्लिकेशन मिटा दिया गया है. हालांकि, user1@cymbalgroup.com के पास अब भी ऐक्सेस है, क्योंकि उन्होंने इसे पहले अलग से इंस्टॉल किया था.

userLicense.get अनुरोध

इस अनुरोध में, userLicense.get तरीके का इस्तेमाल किया गया है. इससे user2@cymbalgroup.com के लाइसेंस का स्टेटस पता चलता है. इससे यह तय किया जा सकता है कि उसके पास ऐप्लिकेशन इस्तेमाल करने की अनुमति है या नहीं.

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

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

जवाब का मुख्य भाग

संगठन में शामिल सभी लोगों के लिए ऐप्लिकेशन मिटा दिया गया था. इसलिए, user2@cymbalgroup.com के लिए जवाब में userLicense संसाधन दिखता है. इसमें enabled फ़ील्ड को false पर सेट किया गया है और state फ़ील्ड को UNLICENSED पर सेट किया गया है. इससे पता चलता है कि इस उपयोगकर्ता के डोमेन के एडमिन ने, इस उपयोगकर्ता को ऐप्लिकेशन के लिए सीट असाइन नहीं की है.

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

userLicense.get अनुरोध

इस अनुरोध में, userLicense.get तरीके का इस्तेमाल किया गया है. इससे user1@cymbalgroup.com के लाइसेंस की स्थिति का पता चलता है. इससे यह तय किया जाता है कि उसके पास ऐप्लिकेशन इस्तेमाल करने की अनुमति है या नहीं.

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

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

जवाब का मुख्य भाग

user1@cymbalgroup.com ने ऐप्लिकेशन को पहले अलग से इंस्टॉल किया था. इसलिए, उसके पास अब भी इसे इस्तेमाल करने की अनुमति है. जवाब में एक userLicense संसाधन दिखता है. इसमें enabled फ़ील्ड को true पर और state फ़ील्ड को 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"
}