REST Resource: customers.telemetry.notificationConfigs
Stay organized with collections
Save and categorize content based on your preferences.
Resource: TelemetryNotificationConfig
Configuration to receive notifications of telemetry data.
JSON representation |
{
"name": string,
"customer": string,
"googleCloudPubsubTopic": string,
"filter": {
object (TelemetryNotificationFilter )
}
} |
Fields |
name |
string
Output only. Resource name of the notification configuration.
|
customer |
string
Output only. Google Workspace customer that owns the resource.
|
googleCloudPubsubTopic |
string
The pubsub topic to which notifications are published to.
|
filter |
object (TelemetryNotificationFilter )
Only send notifications for telemetry data matching this filter.
|
TelemetryNotificationFilter
Configures how the telemetry data should be filtered.
JSON representation |
{
"userOrgUnitId": string,
"deviceOrgUnitId": string,
"userEmail": string,
"deviceId": string,
// Union field filter can be only one of the following:
"telemetryEventNotificationFilter": {
object (TelemetryEventNotificationFilter )
}
// End of list of possible types for union field filter .
} |
Fields |
userOrgUnitId |
string
If set, only sends notifications for telemetry data coming from devices owned by users in this org unit.
|
deviceOrgUnitId |
string
If set, only sends notifications for telemetry data coming from devices in this org unit.
|
userEmail |
string
If set, only sends notifications for telemetry data coming from devices owned by this user.
|
deviceId |
string
If set, only sends notifications for telemetry data coming from this device.
|
Union field filter . Required. filter can be only one of the following: |
telemetryEventNotificationFilter |
object (TelemetryEventNotificationFilter )
Only sends notifications for the telemetry events matching this filter.
|
TelemetryEventNotificationFilter
Configures how the telemetry events should be filtered.
JSON representation |
{
"eventTypes": [
enum (EventType )
]
} |
Fields |
eventTypes[] |
enum (EventType )
Only sends the notifications for events of these types. Must not be empty.
|
Methods |
|
Create a telemetry notification config. |
|
Delete a telemetry notification config. |
|
List all telemetry notification configs. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-06-23 UTC.
[null,null,["Last updated 2025-06-23 UTC."],[[["\u003cp\u003eTelemetryNotificationConfig allows you to receive notifications of telemetry data by configuring a Google Cloud Pubsub topic and filtering the data.\u003c/p\u003e\n"],["\u003cp\u003eYou can filter telemetry data notifications by user, device, organizational unit, or specific telemetry events using TelemetryNotificationFilter and TelemetryEventNotificationFilter.\u003c/p\u003e\n"],["\u003cp\u003eUse the provided methods to create, delete, and list telemetry notification configurations for your Google Workspace customer.\u003c/p\u003e\n"]]],[],null,["# REST Resource: customers.telemetry.notificationConfigs\n\n- [Resource: TelemetryNotificationConfig](#TelemetryNotificationConfig)\n - [JSON representation](#TelemetryNotificationConfig.SCHEMA_REPRESENTATION)\n- [TelemetryNotificationFilter](#TelemetryNotificationFilter)\n - [JSON representation](#TelemetryNotificationFilter.SCHEMA_REPRESENTATION)\n- [TelemetryEventNotificationFilter](#TelemetryEventNotificationFilter)\n - [JSON representation](#TelemetryEventNotificationFilter.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: TelemetryNotificationConfig\n-------------------------------------\n\nConfiguration to receive notifications of telemetry data.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"customer\": string, \"googleCloudPubsubTopic\": string, \"filter\": { object (/chrome/management/reference/rest/v1/customers.telemetry.notificationConfigs#TelemetryNotificationFilter) } } ``` |\n\n| Fields ||\n|--------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. Resource name of the notification configuration. |\n| `customer` | `string` Output only. Google Workspace customer that owns the resource. |\n| `googleCloudPubsubTopic` | `string` The pubsub topic to which notifications are published to. |\n| `filter` | `object (`[TelemetryNotificationFilter](/chrome/management/reference/rest/v1/customers.telemetry.notificationConfigs#TelemetryNotificationFilter)`)` Only send notifications for telemetry data matching this filter. |\n\nTelemetryNotificationFilter\n---------------------------\n\nConfigures how the telemetry data should be filtered.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"userOrgUnitId\": string, \"deviceOrgUnitId\": string, \"userEmail\": string, \"deviceId\": string, // Union field `filter` can be only one of the following: \"telemetryEventNotificationFilter\": { object (/chrome/management/reference/rest/v1/customers.telemetry.notificationConfigs#TelemetryEventNotificationFilter) } // End of list of possible types for union field `filter`. } ``` |\n\n| Fields ||\n|------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `userOrgUnitId` | `string` If set, only sends notifications for telemetry data coming from devices owned by users in this org unit. |\n| `deviceOrgUnitId` | `string` If set, only sends notifications for telemetry data coming from devices in this org unit. |\n| `userEmail` | `string` If set, only sends notifications for telemetry data coming from devices owned by this user. |\n| `deviceId` | `string` If set, only sends notifications for telemetry data coming from this device. |\n| Union field `filter`. Required. `filter` can be only one of the following: ||\n| `telemetryEventNotificationFilter` | `object (`[TelemetryEventNotificationFilter](/chrome/management/reference/rest/v1/customers.telemetry.notificationConfigs#TelemetryEventNotificationFilter)`)` Only sends notifications for the telemetry events matching this filter. |\n\nTelemetryEventNotificationFilter\n--------------------------------\n\nConfigures how the telemetry events should be filtered.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------|\n| ``` { \"eventTypes\": [ enum (/chrome/management/reference/rest/v1/EventType) ] } ``` |\n\n| Fields ||\n|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------|\n| `eventTypes[]` | `enum (`[EventType](/chrome/management/reference/rest/v1/EventType)`)` Only sends the notifications for events of these types. Must not be empty. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------------------------|------------------------------------------|\n| ### [create](/chrome/management/reference/rest/v1/customers.telemetry.notificationConfigs/create) | Create a telemetry notification config. |\n| ### [delete](/chrome/management/reference/rest/v1/customers.telemetry.notificationConfigs/delete) | Delete a telemetry notification config. |\n| ### [list](/chrome/management/reference/rest/v1/customers.telemetry.notificationConfigs/list) | List all telemetry notification configs. |"]]