API توکن‌های ثبت‌نام مدیریت کروم به مدیران اجازه می‌دهد تا توکن‌های ثبت‌نام مورد استفاده برای ثبت‌نام مرورگرهای کروم در Chrome Enterprise Core را مدیریت کنند. این مجموعه از APIها می‌توانند برای ایجاد، بازیابی، فهرست‌بندی و لغو توکن‌های ثبت‌نام برای دستگاه‌هایشان استفاده شوند.
مرور سریع متدهای API
آدرس‌های اینترنتی (URL) نسبت به https://chromemanagement.googleapis.com/v1/customers/{customer_id} هستند.
| توضیحات | آدرس اینترنتی نسبی | روش اچ‌تی‌پی |
|---|---|---|
| ایجاد توکن ثبت نام | /enrollmentTokens | پست |
| بازیابی توکن ثبت نام | /enrollmentTokens/{token_permanent_id} | دریافت کنید |
| فهرست توکن‌های ثبت‌نام | /enrollmentTokens | دریافت کنید |
| ابطال توکن ثبت نام | /enrollmentTokens/{token_permanent_id}:لغو | پست |
برای مثال، نمونه کدها را برای درخواست‌ها و پاسخ‌ها ببینید.
فیلتر کردن نتایج
هنگام فهرست کردن توکن‌های ثبت‌نام با استفاده از متد /enrollmentTokens ، می‌توانید نتایج را با استفاده از پارامتر filter کوئری محدود کنید. همه پارامترهای فیلتر باید هنگام ارسال درخواست‌های HTTP، URL-escaped باشند. می‌توان چندین شرط را با استفاده از عملگر AND ترکیب کرد.
- فیلدهای رشته‌ای و شمارشی: از عملگرهای مقایسه‌ای
=و:پشتیبانی می‌کنند. - فیلتر کردن واحد سازمانی: شما می‌توانید توکن‌های ایجاد شده برای یک واحد سازمانی خاص را با مشخص کردن
org_unit_pathیاorg_unit_idفیلتر کنید.
فیلدهای قابل فیلتر
| میدان | توضیحات |
|---|---|
device_type | نوع دستگاهی که توکن‌های ثبت‌نام برای آن استفاده می‌شوند (در حال حاضر CHROME_BROWSER ). |
token_state | وضعیت توکن ثبت نام ( ACTIVE ، EXPIRED ، REVOKED ). |
org_unit_path | مسیر واحد سازمانی برای توکن ثبت نام (مثلاً /Marketing ). |
org_unit_id | واحد سازمانی، شناسه‌ی توکن ثبت‌نام را مبهم‌سازی کرده است. |
امتیازات مدیر
API توکن‌های ثبت نام مدیریت کروم، واگذاری نقش مدیر را رعایت می‌کند.
| روش | امتیازات مدیریتی مورد نیاز است |
|---|---|
| ایجاد توکن ثبت نام | «سرویس‌ها -> مدیریت کروم -> تنظیمات -> مرورگرهای مدیریت‌شده» |
| دریافت توکن ثبت نام | «سرویس‌ها -> مدیریت کروم -> تنظیمات -> مرورگرهای مدیریت‌شده» یا «سرویس‌ها -> مدیریت کروم -> تنظیمات -> مرورگرهای مدیریت‌شده -> خواندن» |
| توکن‌های ثبت لیست | «سرویس‌ها -> مدیریت کروم -> تنظیمات -> مرورگرهای مدیریت‌شده» یا «سرویس‌ها -> مدیریت کروم -> تنظیمات -> مرورگرهای مدیریت‌شده -> خواندن» |
| لغو توکن ثبت نام | «سرویس‌ها -> مدیریت کروم -> تنظیمات -> مرورگرهای مدیریت‌شده» |
برای مدیریت نقش‌ها و امتیازات مدیر، به «کنسول مدیریت -> نقش‌های مدیریت» مراجعه کنید.
دامنه‌های API
API توکن‌های ثبت نام مدیریت کروم به محدوده‌های OAuth زیر نیاز دارد:
| روش | دامنه‌های OAuth مورد نیاز است |
|---|---|
| ایجاد توکن ثبت نام | https://www.googleapis.com/auth/chrome.management.enrollmenttokens |
| دریافت توکن ثبت نام | https://www.googleapis.com/auth/chrome.management.enrollmenttokens یا https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly |
| توکن‌های ثبت لیست | https://www.googleapis.com/auth/chrome.management.enrollmenttokens یا https://www.googleapis.com/auth/chrome.management.enrollmenttokens.readonly |
| لغو توکن ثبت نام | https://www.googleapis.com/auth/chrome.management.enrollmenttokens |
برای اطلاعات بیشتر، به مرور کلی احراز هویت مراجعه کنید.