- درخواست HTTP
- پارامترهای مسیر
- درخواست بدنه
- بدنه پاسخ
- دامنههای مجوز
- اطلاعات اشتراک سالانه
- تعداد مجوزها
- اطلاعات مجوز دائمی
- امتحانش کن!
اطلاعات اشتراک و مجوز تجمیعشده برای یک مشتری مشخص را به عنوان یک منبع واحد دریافت میکند. توجه: از آنجایی که دادهها برای دستگاههای ChromeOS اسنپشات میشوند، اعداد دقیق میتوانند تا 10 ثانیه تأخیر داشته باشند.
درخواست HTTP
GET https://chromemanagement.googleapis.com/v1/{name=customers/*/subscriptionInfo}
این URL از سینتکس Transcoding در gRPC استفاده میکند.
پارامترهای مسیر
| پارامترها | |
|---|---|
name | الزامی. نام منبع اطلاعات اشتراک مشتری که قرار است بازیابی شود. فرمت: customers/{customer}/subscriptionInfo |
درخواست بدنه
بدنه درخواست باید خالی باشد.
بدنه پاسخ
منبع Singleton که اطلاعات اشتراک و مجوز را برای یک مشتری مشخص نشان میدهد.
در صورت موفقیت، بدنه پاسخ شامل دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{ "name": string, "chromeEnterpriseUpgradeAnnual": { object ( |
| فیلدها | |
|---|---|
name | شناسه. نام منبع اطلاعات اشتراک مشتری. قالب: customers/{customer}/subscriptionInfo |
chromeEnterpriseUpgradeAnnual | فقط خروجی. جزئیات مربوط به SKU سالانه ارتقاء Chrome Enterprise. |
kioskSignageUpgradeAnnual | فقط خروجی. جزئیات مربوط به کد کالا (SKU) سالانه ارتقاء کیوسک و تابلو. |
chromePerpetualUpgrade | فقط خروجی. جزئیات مربوط به SKU دائمی ارتقاء Chrome Ent/Edu. |
دامنههای مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/chrome.management.subscriptions.readonly
اطلاعات اشتراک سالانه
اطلاعات مربوط به اشتراکها/مجوزهای تکرارشونده سالانه.
| نمایش JSON |
|---|
{
"counts": {
object ( |
| فیلدها | |
|---|---|
counts | فقط خروجی. مجوز برای این اشتراک معتبر است. |
subscriptionEndTime | فقط خروجی. تاریخی که دوره اشتراک فعلی به پایان میرسد. از RFC 3339 استفاده میکند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده میکند. آفستهای غیر از "Z" نیز پذیرفته میشوند. مثالها: |
تعداد مجوزها
تعداد منابع برای یک نوع مجوز خاص.
| نمایش JSON |
|---|
{ "totalPurchasedCount": string, "assignedCount": string, "unassignedCount": string } |
| فیلدها | |
|---|---|
totalPurchasedCount | فقط خروجی. تعداد کل مجوزهای خریداری شده. |
assignedCount | فقط خروجی. تعداد کل مجوزهایی که در حال حاضر به کاربران یا دستگاهها اختصاص داده شده است. |
unassignedCount | فقط خروجی. تعداد کل مجوزهای موجود برای واگذاری. |
اطلاعات مجوز دائمی
اطلاعات مربوط به مجوزهای دائمی.
| نمایش JSON |
|---|
{
"counts": {
object ( |
| فیلدها | |
|---|---|
counts | فقط خروجی. مجوز برای SKU دائمی محاسبه میشود. |
retiredCount | فقط خروجی. تعداد ارتقاءهای دائمی که خریداری شدهاند اما دیگر برای ثبت نام در دسترس نیستند. اینها ارتقاءهای دائمی هستند که در دستگاهی ثبت شدهاند که از آن زمان از رده خارج شده است و ارتقاء نمیتواند منتقل شود یا دوباره در دستگاه دیگری استفاده شود. مجوزهای از رده خارج شده زیرمجموعهای از کل اختصاص داده شده هستند. |
conditionallyAvailableCount | فقط خروجی. تعداد ارتقاءهای دائمی مستقل که قبلاً ثبت شده و بعداً به دلایل RMA، گارانتی یا تعمیر از ثبت خارج شدهاند و فقط برای استفاده مجدد در همان مدل دستگاه در دسترس هستند. مجوزهای مشروط موجود، زیرمجموعهای از کل اختصاص داده شده هستند. |