Method: customers.getSubscriptionInfo

यह फ़ंक्शन, किसी ग्राहक के लिए सदस्यता और लाइसेंस की एग्रीगेट की गई जानकारी को सिंगलटन संसाधन के तौर पर दिखाता है. ध्यान दें: ChromeOS डिवाइसों के लिए डेटा का स्नैपशॉट लिया जाता है. इसलिए, सटीक संख्याएं दिखने में 10 सेकंड तक लग सकते हैं.

एचटीटीपी अनुरोध

GET https://chromemanagement.googleapis.com/v1/{name=customers/*/subscriptionInfo}

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
name

string

ज़रूरी है. ग्राहक की सदस्यता की जानकारी का वह संसाधन नाम जिसे वापस पाना है. फ़ॉर्मैट: customers/{customer}/subscriptionInfo

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

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

सिंगलटन संसाधन, जो किसी ग्राहक के लिए सदस्यता और लाइसेंस की जानकारी दिखाता है.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON फ़ॉर्मैट में दिखाया गया है
{
  "name": string,
  "chromeEnterpriseUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "kioskSignageUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "chromePerpetualUpgrade": {
    object (PerpetualLicenseInfo)
  }
}
फ़ील्ड
name

string

आइडेंटिफ़ायर. ग्राहक की सदस्यता की जानकारी का संसाधन नाम. फ़ॉर्मैट: customers/{customer}/subscriptionInfo

chromeEnterpriseUpgradeAnnual

object (AnnualSubscriptionInfo)

सिर्फ़ आउटपुट के लिए. Chrome Enterprise Upgrade के सालाना एसकेयू के बारे में जानकारी.

kioskSignageUpgradeAnnual

object (AnnualSubscriptionInfo)

सिर्फ़ आउटपुट के लिए. Kiosk & Signage Upgrade के सालाना एसकेयू की जानकारी.

chromePerpetualUpgrade

object (PerpetualLicenseInfo)

सिर्फ़ आउटपुट के लिए. Chrome Ent/Edu Upgrade Perpetual SKU के बारे में जानकारी.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/chrome.management.subscriptions.readonly

AnnualSubscriptionInfo

हर साल रिन्यू होने वाली सदस्यताओं/लाइसेंस के बारे में जानकारी.

JSON के काेड में दिखाना
{
  "counts": {
    object (LicenseCounts)
  },
  "subscriptionEndTime": string
}
फ़ील्ड
counts

object (LicenseCounts)

सिर्फ़ आउटपुट के लिए. इस सदस्यता के लिए लाइसेंस की संख्या.

subscriptionEndTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. मौजूदा सदस्यता की अवधि खत्म होने की तारीख.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".

LicenseCounts

किसी खास तरह के लाइसेंस के लिए संसाधन की संख्या.

JSON के काेड में दिखाना
{
  "totalPurchasedCount": string,
  "assignedCount": string,
  "unassignedCount": string
}
फ़ील्ड
totalPurchasedCount

string (int64 format)

सिर्फ़ आउटपुट के लिए. खरीदे गए लाइसेंस की कुल संख्या.

assignedCount

string (int64 format)

सिर्फ़ आउटपुट के लिए. उपयोगकर्ताओं या डिवाइसों को असाइन किए गए लाइसेंस की कुल संख्या.

unassignedCount

string (int64 format)

सिर्फ़ आउटपुट के लिए. असाइन किए जा सकने वाले लाइसेंस की कुल संख्या.

PerpetualLicenseInfo

हमेशा के लिए मिलने वाले लाइसेंस के बारे में जानकारी.

JSON के काेड में दिखाना
{
  "counts": {
    object (LicenseCounts)
  },
  "retiredCount": string,
  "conditionallyAvailableCount": string
}
फ़ील्ड
counts

object (LicenseCounts)

सिर्फ़ आउटपुट के लिए. परपेचुअल एसकेयू के लिए लाइसेंस की संख्या.

retiredCount

string (int64 format)

सिर्फ़ आउटपुट के लिए. हमेशा के लिए उपलब्ध ऐसे अपग्रेड की संख्या जिन्हें खरीदा गया था, लेकिन अब रजिस्ट्रेशन के लिए उपलब्ध नहीं हैं. ये हमेशा के लिए उपलब्ध ऐसे अपग्रेड हैं जो किसी ऐसे डिवाइस के लिए रजिस्टर किए गए थे जिसे अब इस्तेमाल नहीं किया जा सकता. इन अपग्रेड को किसी दूसरे डिवाइस पर ट्रांसफ़र या फिर से इस्तेमाल नहीं किया जा सकता. बंद किए गए लाइसेंस, असाइन किए गए कुल लाइसेंस का सबसेट होते हैं.

conditionallyAvailableCount

string (int64 format)

सिर्फ़ आउटपुट के लिए. हमेशा के लिए उपलब्ध ऐसे अपग्रेड की संख्या जो किसी डिवाइस पर पहले रजिस्टर किए गए थे और बाद में आरएमए, वारंटी या रिपेयर की वजह से इस्तेमाल से बाहर कर दिए गए थे. इन्हें सिर्फ़ उसी मॉडल वाले डिवाइस पर फिर से इस्तेमाल किया जा सकता है. शर्तों के साथ उपलब्ध लाइसेंस, असाइन किए गए कुल लाइसेंस का सबसेट होते हैं.