Lists service accounts with subscriber privileges on the Pub/Sub topic created for this Channel Services account or integrator.
Possible error codes:
PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin.
INVALID_ARGUMENT: Required request parameters are missing or invalid.
NOT_FOUND: The topic resource doesn't exist.
INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support.
UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support.
Return value: A list of service email addresses.
HTTP request
GET https://cloudchannel.googleapis.com/v1/{account=accounts/*}:listSubscribers
Optional. Resource name of the account. Required if integrator is not provided. Otherwise, leave this field empty/unset.
Query parameters
Parameters
pageSize
integer
Optional. The maximum number of service accounts to return. The service may return fewer than this value. If unspecified, returns at most 100 service accounts. The maximum value is 1000; the server will coerce values above 1000.
pageToken
string
Optional. A page token, received from a previous accounts.listSubscribers call. Provide this to retrieve the subsequent page.
When paginating, all other parameters provided to accounts.listSubscribers must match the call that provided the page token.
integrator
string
Optional. Resource name of the integrator. Required if account is not provided. Otherwise, leave this field empty/unset.
[[["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-05-19 UTC."],[[["\u003cp\u003eThis API endpoint retrieves a list of service accounts with subscriber privileges for a specific Pub/Sub topic.\u003c/p\u003e\n"],["\u003cp\u003eThe request can be made using either an \u003ccode\u003eaccount\u003c/code\u003e or an \u003ccode\u003eintegrator\u003c/code\u003e path parameter, with the other left empty/unset.\u003c/p\u003e\n"],["\u003cp\u003eOptional query parameters, \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e, allow for controlling the number of service accounts returned and for retrieving subsequent pages of results, respectively.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and the response body will contain a \u003ccode\u003eListSubscribersResponse\u003c/code\u003e object upon success.\u003c/p\u003e\n"],["\u003cp\u003eAccessing this endpoint requires the \u003ccode\u003ehttps://www.googleapis.com/auth/apps.order\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.listSubscribers\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- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists service accounts with subscriber privileges on the Pub/Sub topic created for this Channel Services account or integrator.\n\nPossible error codes:\n\n- PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin.\n- INVALID_ARGUMENT: Required request parameters are missing or invalid.\n- NOT_FOUND: The topic resource doesn't exist.\n- INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support.\n- UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support.\n\nReturn value: A list of service email addresses.\n\n### HTTP request\n\n`GET https://cloudchannel.googleapis.com/v1/{account=accounts/*}:listSubscribers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [ListSubscribersResponse](/channel/docs/reference/rest/v1/ListSubscribersResponse).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/apps.order`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
