Method: customers.getSubscriptionInfo

اطلاعات اشتراک و مجوز تجمیع‌شده برای یک مشتری مشخص را به عنوان یک منبع واحد دریافت می‌کند. توجه: از آنجایی که داده‌ها برای دستگاه‌های ChromeOS اسنپ‌شات می‌شوند، اعداد دقیق می‌توانند تا 10 ثانیه تأخیر داشته باشند.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
name

string

الزامی. نام منبع اطلاعات اشتراک مشتری که قرار است بازیابی شود. فرمت: customers/{customer}/subscriptionInfo

درخواست بدنه

بدنه درخواست باید خالی باشد.

بدنه پاسخ

منبع Singleton که اطلاعات اشتراک و مجوز را برای یک مشتری مشخص نشان می‌دهد.

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON
{
  "name": string,
  "chromeEnterpriseUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "kioskSignageUpgradeAnnual": {
    object (AnnualSubscriptionInfo)
  },
  "chromePerpetualUpgrade": {
    object (PerpetualLicenseInfo)
  }
}
فیلدها
name

string

شناسه. نام منبع اطلاعات اشتراک مشتری. قالب: customers/{customer}/subscriptionInfo

chromeEnterpriseUpgradeAnnual

object ( AnnualSubscriptionInfo )

فقط خروجی. جزئیات مربوط به SKU سالانه ارتقاء Chrome Enterprise.

kioskSignageUpgradeAnnual

object ( AnnualSubscriptionInfo )

فقط خروجی. جزئیات مربوط به کد کالا (SKU) سالانه ارتقاء کیوسک و تابلو.

chromePerpetualUpgrade

object ( PerpetualLicenseInfo )

فقط خروجی. جزئیات مربوط به SKU دائمی ارتقاء Chrome Ent/Edu.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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

اطلاعات اشتراک سالانه

اطلاعات مربوط به اشتراک‌ها/مجوزهای تکرارشونده سالانه.

نمایش JSON
{
  "counts": {
    object (LicenseCounts)
  },
  "subscriptionEndTime": string
}
فیلدها
counts

object ( LicenseCounts )

فقط خروجی. مجوز برای این اشتراک معتبر است.

subscriptionEndTime

string ( Timestamp format)

فقط خروجی. تاریخی که دوره اشتراک فعلی به پایان می‌رسد.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

تعداد مجوزها

تعداد منابع برای یک نوع مجوز خاص.

نمایش JSON
{
  "totalPurchasedCount": string,
  "assignedCount": string,
  "unassignedCount": string
}
فیلدها
totalPurchasedCount

string ( int64 format)

فقط خروجی. تعداد کل مجوزهای خریداری شده.

assignedCount

string ( int64 format)

فقط خروجی. تعداد کل مجوزهایی که در حال حاضر به کاربران یا دستگاه‌ها اختصاص داده شده است.

unassignedCount

string ( int64 format)

فقط خروجی. تعداد کل مجوزهای موجود برای واگذاری.

اطلاعات مجوز دائمی

اطلاعات مربوط به مجوزهای دائمی.

نمایش JSON
{
  "counts": {
    object (LicenseCounts)
  },
  "retiredCount": string,
  "conditionallyAvailableCount": string
}
فیلدها
counts

object ( LicenseCounts )

فقط خروجی. مجوز برای SKU دائمی محاسبه می‌شود.

retiredCount

string ( int64 format)

فقط خروجی. تعداد ارتقاءهای دائمی که خریداری شده‌اند اما دیگر برای ثبت نام در دسترس نیستند. اینها ارتقاءهای دائمی هستند که در دستگاهی ثبت شده‌اند که از آن زمان از رده خارج شده است و ارتقاء نمی‌تواند منتقل شود یا دوباره در دستگاه دیگری استفاده شود. مجوزهای از رده خارج شده زیرمجموعه‌ای از کل اختصاص داده شده هستند.

conditionallyAvailableCount

string ( int64 format)

فقط خروجی. تعداد ارتقاءهای دائمی مستقل که قبلاً ثبت شده و بعداً به دلایل RMA، گارانتی یا تعمیر از ثبت خارج شده‌اند و فقط برای استفاده مجدد در همان مدل دستگاه در دسترس هستند. مجوزهای مشروط موجود، زیرمجموعه‌ای از کل اختصاص داده شده هستند.