Lists the descriptors for supported channel types. The use of descriptors makes it possible for new channel types to be dynamically added.
HTTP request
GET https://monitoring.googleapis.com/v3/{name}/notificationChannelDescriptors
Path parameters
Parameters
name
string
Required. The REST resource name of the parent from which to retrieve the notification channel descriptors. The expected syntax is:
projects/[PROJECT_ID_OR_NUMBER]
Note that this names the parent container in which to look for the descriptors; to retrieve a single descriptor by name, use the notificationChannelDescriptors.get operation, instead.
Authorization requires the following IAM permission on the specified resource name:
monitoring.notificationChannelDescriptors.list
Query parameters
Parameters
pageSize
integer
The maximum number of results to return in a single response. If not set to a positive number, a reasonable value will be chosen by the service.
pageToken
string
If non-empty, pageToken must contain a value returned as the nextPageToken in a previous response to request the next set of results.
Request body
The request body must be empty.
Response body
The notificationChannelDescriptors.list response.
If successful, the response body contains data with the following structure:
The monitored resource descriptors supported for the specified project, optionally filtered.
nextPageToken
string
If not empty, indicates that there may be more results that match the request. Use the value in the pageToken field in a subsequent request to fetch the next set of results. If empty, all results have been returned.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-23 UTC."],[],[],null,["# Method: projects.notificationChannelDescriptors.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListNotificationChannelDescriptorsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists the descriptors for supported channel types. The use of descriptors makes it possible for new channel types to be dynamically added.\n\n### HTTP request\n\n`GET https://monitoring.googleapis.com/v3/{name}/notificationChannelDescriptors`\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe `notificationChannelDescriptors.list` response.\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/monitoring`\n- `\n https://www.googleapis.com/auth/monitoring.read`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]