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/v1alpha1/{integrator=integrators/*}:listSubscribers
Optional. Resource name of the integrator. Required if account is not provided. Otherwise, leave this field empty/unset.
Query parameters
Parameters
account
string
Optional. Resource name of the account. Required if integrator is not provided. Otherwise, leave this field empty/unset.
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 integrators.listSubscribers call. Provide this to retrieve the subsequent page.
When paginating, all other parameters provided to integrators.listSubscribers must match the call that provided the page token.
[[["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 page details how to list service accounts with subscriber privileges on a Pub/Sub topic using the \u003ccode\u003eintegrators.listSubscribers\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request uses a \u003ccode\u003eGET\u003c/code\u003e method with a URL structured via gRPC Transcoding, requiring either an \u003ccode\u003eintegrator\u003c/code\u003e or \u003ccode\u003eaccount\u003c/code\u003e path parameter.\u003c/p\u003e\n"],["\u003cp\u003eQuery parameters such as \u003ccode\u003eaccount\u003c/code\u003e, \u003ccode\u003epageSize\u003c/code\u003e, and \u003ccode\u003epageToken\u003c/code\u003e are optional and allow for filtering and pagination of the list of service accounts returned.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must be empty, and the response body, if successful, will be a \u003ccode\u003eListSubscribersResponse\u003c/code\u003e instance containing a list of service email addresses.\u003c/p\u003e\n"],["\u003cp\u003eTo successfully authorize the request, the \u003ccode\u003ehttps://www.googleapis.com/auth/apps.order\u003c/code\u003e OAuth scope is required, as detailed within the Authorization section.\u003c/p\u003e\n"]]],[],null,["# Method: integrators.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/v1alpha1/{integrator=integrators/*}: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/v1alpha1/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)."]]
