REST Resource: customers.chromeBrowsers

منبع: مرورگر کروم

دستگاهی با مرورگرهای کروم مدیریت‌شده.

نمایش JSON 
{
  "name": string,
  "browserPermanentId": string,
  "lastPolicyFetchTime": string,
  "osPlatform": string,
  "osArchitecture": string,
  "osVersion": string,
  "machineName": string,
  "annotatedLocation": string,
  "annotatedUser": string,
  "annotatedAssetId": string,
  "annotatedNotes": string,
  "lastRegistrationTime": string,
  "extensionCount": string,
  "policyCount": string,
  "lastDeviceUser": string,
  "lastActivityTime": string,
  "osPlatformVersion": string,
  "browserVersions": [
    string
  ],
  "lastStatusReportTime": string,
  "lastDeviceUsers": [
    {
      object (BrowserUser)
    }
  ],
  "machinePolicies": [
    {
      object (Policy)
    }
  ],
  "browsers": [
    {
      object (Browser)
    }
  ],
  "serialNumber": string,
  "virtualDeviceId": string,
  "machineExtensionPolicies": [
    {
      object (ExtensionPolicy)
    }
  ],
  "orgUnitId": string,
  "deviceIdentifiersHistory": {
    object (DeviceIdentifiersHistory)
  },
  "attestationCredential": {
    object (AttestationCredential)
  },
  "omahaRecentFetchTime": string
}
فیلدها
name

string

شناسه. قالب: customers/{customerId}/chromeBrowsers/{browserPermanentId}

browserPermanentId

string

فقط خروجی. شناسه منحصر به فرد مرورگر کروم.

lastPolicyFetchTime

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" .

osPlatform

string

فقط خروجی. پلتفرم سیستم عامل دستگاه.

osArchitecture

string

فقط خروجی. معماری پردازنده دستگاه.

osVersion

string

فقط خروجی. نسخه سیستم عامل دستگاه.

machineName

string

فقط خروجی. نام دستگاه.

annotatedLocation

string

اختیاری. آدرس یا موقعیت مکانی دستگاه که توسط مدیر مشخص شده است.

annotatedUser

string

اختیاری. کاربر دستگاه طبق توضیحات مدیر.

annotatedAssetId

string

اختیاری. شناسه دارایی همانطور که توسط مدیر حاشیه‌نویسی شده یا هنگام ثبت‌نام مشخص شده است.

annotatedNotes

string

اختیاری. یادداشت‌هایی درباره این دستگاه که توسط مدیر حاشیه‌نویسی شده‌اند.

lastRegistrationTime

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" .

extensionCount

string ( int64 format)

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

policyCount

string ( int64 format)

فقط خروجی. تعداد خط‌مشی‌های مجزای تنظیم‌شده روی تمام مرورگرهای کروم این دستگاه.

lastDeviceUser

string

فقط خروجی. آخرین کاربری که در این دستگاه با مرورگر کروم وارد سیستم شده است.

lastActivityTime

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" .

osPlatformVersion

string

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

browserVersions[]

string

فقط خروجی. فهرست تمام نسخه‌های مرورگر نصب‌شده روی این دستگاه.

lastStatusReportTime

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" .

lastDeviceUsers[]

object ( BrowserUser )

فقط خروجی. فهرست کاربران اخیر مرورگر، به ترتیب نزولی بر اساس آخرین زمان گزارش.

machinePolicies[]

object ( Policy )

فقط خروجی. فهرست تمام خط‌مشی‌های سطح دستگاه که برای مرورگرهای کروم در این دستگاه تنظیم شده‌اند.

browsers[]

object ( Browser )

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

serialNumber

string

فقط خروجی. شماره سریال دستگاه.

virtualDeviceId

string

فقط خروجی. شناسه اولیه دستگاه که توسط اولین مرورگر کرومی که این دستگاه را ثبت کرده است، ارسال شده است.

machineExtensionPolicies[]

object ( ExtensionPolicy )

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

orgUnitId

string

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

deviceIdentifiersHistory

object ( DeviceIdentifiersHistory )

فقط خروجی. تاریخچه شناسه‌های گزارش شده به این دستگاه.

attestationCredential

object ( AttestationCredential )

فقط خروجی. اعتبارنامه‌ی تأیید مورد استفاده برای رابط اعتماد دستگاه.

omahaRecentFetchTime

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 
{
  "userName": string,
  "lastStatusReportTime": string
}
فیلدها
userName

string

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

lastStatusReportTime

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 
{
  "source": enum (PolicySource),
  "policyName": string,
  "value": string,
  "error": string
}
فیلدها
source

enum ( PolicySource )

فقط خروجی. منبع خط‌مشی.

policyName

string

فقط خروجی. نام سیاست.

value

string

فقط خروجی. مقدار سیاست.

error

string

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

مرورگر

نصب خاص کروم روی دستگاهی با مرورگرهای مدیریت‌شده کروم.

نمایش JSON 
{
  "browserVersion": string,
  "channel": enum (Channel),
  "lastStatusReportTime": string,
  "lastPolicyFetchTime": string,
  "executablePath": string,
  "plugins": [
    {
      object (Plugin)
    }
  ],
  "profiles": [
    {
      object (Profile)
    }
  ],
  "pendingInstallVersion": string
}
فیلدها
browserVersion

string

فقط خروجی. نسخه مرورگر نصب شده است.

channel

enum ( Channel )

فقط خروجی. کانال مرورگر نصب شده.

lastStatusReportTime

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" .

lastPolicyFetchTime

string ( Timestamp format)

فقط خروجی. زمانی که آخرین درخواست برای واکشی سیاست‌ها در این مرورگر Chrome با موفقیت انجام شده است.

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

executablePath

string

فقط خروجی. مسیر فایل اجرایی Chrome.exe برای این مرورگر.

plugins[]

object ( Plugin )

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

profiles[]

object ( Profile )

فقط خروجی. فهرست پروفایل‌های این مرورگر.

pendingInstallVersion

string

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

کانال

کانال‌های انتشار احتمالی یک مرورگر.

انوم‌ها
CHANNEL_UNSPECIFIED نشان دهنده یک کانال نامشخص است.
CHANNEL_STABLE نشان دهنده یک کانال پایدار است.
CHANNEL_BETA نشان دهنده یک کانال بتا است.
CHANNEL_DEV نشان دهنده یک کانال توسعه دهنده است.
CHANNEL_CANARY نشان دهنده یک کانال قناری است.

افزونه

اطلاعات مربوط به افزونه مرورگر کروم نصب شده روی یک کروم نصب شده گزارش شده در دستگاهی با مرورگرهای کروم مدیریت شده.

نمایش JSON 
{
  "pluginName": string,
  "description": string,
  "filename": string
}
فیلدها
pluginName

string

فقط خروجی. نام افزونه نصب شده.

description

string

فقط خروجی. شرح افزونه نصب شده.

filename

string

فقط خروجی. نام فایل افزونه نصب شده.

پروفایل

نمایه‌ای که از نصب کروم روی دستگاهی با مرورگرهای کروم مدیریت‌شده گزارش داده است.

نمایش JSON 
{
  "profileName": string,
  "id": string,
  "lastStatusReportTime": string,
  "lastPolicyFetchTime": string,
  "safeBrowsingWarnings": string,
  "safeBrowsingWarningsClickThroughs": string,
  "chromeSignedInUserEmail": string,
  "extensions": [
    {
      object (Extension)
    }
  ],
  "userPolicies": [
    {
      object (Policy)
    }
  ],
  "extensionPolicies": [
    {
      object (ExtensionPolicy)
    }
  ],
  "safeBrowsingWarningsResetTime": string
}
فیلدها
profileName

string

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

id

string

فقط خروجی. یک شناسه منحصر به فرد برای این نمایه.

lastStatusReportTime

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" .

lastPolicyFetchTime

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" .

safeBrowsingWarnings

string ( int64 format)

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

safeBrowsingWarningsClickThroughs

string ( int64 format)

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

chromeSignedInUserEmail

string

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

extensions[]

object ( Extension )

فقط خروجی. فهرست افزونه‌های نصب‌شده برای این نمایه.

userPolicies[]

object ( Policy )

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

extensionPolicies[]

object ( ExtensionPolicy )

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

safeBrowsingWarningsResetTime

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 
{
  "extensionId": string,
  "version": string,
  "permissions": [
    string
  ],
  "extensionName": string,
  "description": string,
  "appType": enum (ExtensionType),
  "homepageUri": string,
  "installType": enum (InstallationType),
  "configuredAppPolicy": enum (ConfiguredAppPolicy),
  "disabled": boolean,
  "icons": [
    {
      object (ExtensionIcon)
    }
  ],
  "manifestVersion": integer
}
فیلدها
extensionId

string

فقط خروجی. شناسه افزونه.

version

string

فقط خروجی. نسخه افزونه.

permissions[]

string

فقط خروجی. فهرست مجوزهای مورد نیاز برای این افزونه.

extensionName

string

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

description

string

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

appType

enum ( ExtensionType )

فقط خروجی. نوع داخلی.

homepageUri

string

فقط خروجی. نشانی اینترنتی صفحه اصلی این افزونه.

installType

enum ( InstallationType )

فقط خروجی. نحوه نصب افزونه.

configuredAppPolicy

enum ( ConfiguredAppPolicy )

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

disabled

boolean

فقط خروجی. اینکه آیا افزونه غیرفعال است یا خیر.

icons[]

object ( ExtensionIcon )

فقط خروجی. فهرست آیکون‌های موجود برای این افزونه.

manifestVersion

integer

فقط خروجی. نسخه مانیفست این افزونه.

سیاست برنامه پیکربندی‌شده

سیاست‌های احتمالی پیکربندی‌شده‌ی برنامه برای یک افزونه.

انوم‌ها
CONFIGURED_APP_POLICY_UNSPECIFIED نشان‌دهنده‌ی یک سیاست برنامه‌ی پیکربندی‌شده‌ی نامشخص است.
CONFIGURED_APP_POLICY_NONE هیچ خط‌مشی برنامه پیکربندی‌شده‌ای را نشان نمی‌دهد.
CONFIGURED_APP_POLICY_SHOULD_FORCE نشان دهنده‌ی افزونه‌ای است که باید اجباری اجرا شود.
CONFIGURED_APP_POLICY_SHOULD_BLOCK نشان‌دهنده‌ی افزونه‌ای است که باید مسدود شود.

آیکون افزونه

نمادی از افزونه مرورگر کروم.

نمایش JSON 
{
  "size": integer,
  "uri": string
}
فیلدها
size

integer

فقط خروجی. اندازه آیکون افزونه.

uri

string

فقط خروجی. نشانی اینترنتی (URL) نماد افزونه.

سیاست توسعه

خط‌مشی‌های گزارش‌شده بر افزونه‌ای که روی نمایه Chrome نصب شده است، اعمال شده است.

نمایش JSON 
{
  "extensionId": string,
  "extensionName": string,
  "policies": [
    {
      object (Policy)
    }
  ]
}
فیلدها
extensionId

string

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

extensionName

string

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

policies[]

object ( Policy )

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

تاریخچه شناسه‌های دستگاه

تاریخچه شناسه‌های دستگاه گزارش‌شده از یک دستگاه.

نمایش JSON 
{
  "records": [
    {
      object (DeviceIdentifiersRecord)
    }
  ],
  "deviceIdCollision": boolean,
  "lastDeviceIdCollisionDetectionTime": string
}
فیلدها
records[]

object ( DeviceIdentifiersRecord )

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

deviceIdCollision

boolean

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

lastDeviceIdCollisionDetectionTime

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 
{
  "identifiers": {
    object (DeviceIdentifiers)
  },
  "firstRecordTime": string,
  "lastActivityTime": string
}
فیلدها
identifiers

object ( DeviceIdentifiers )

فقط خروجی. شناسه‌های دستگاه.

firstRecordTime

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" .

lastActivityTime

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 
{
  "machineName": string,
  "serialNumber": string,
  "hostName": string
}
فیلدها
machineName

string

فقط خروجی. نام دستگاه مرتبط با دستگاه.

serialNumber

string

فقط خروجی. شماره سریال دستگاه.

hostName

string

فقط خروجی. نام میزبان دستگاه.

روش‌ها

delete

 داده‌های جمع‌آوری‌شده از نمایه مرورگر Chrome را حذف می‌کند.

get

 یک مرورگر کروم واحد را که توسط شناسه مشتری و شناسه منبع آن شناسایی شده است، بازیابی می‌کند.

list

 تمام مرورگرهای کروم یک مشتری (به صورت صفحه‌بندی شده) را بازیابی می‌کند.

move

 مرورگرهای مدیریت‌شده‌ی کروم را به یک واحد سازمانی (OU) جدید منتقل می‌کند.

patch

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