Unregisters a service account with subscriber privileges on the Pub/Sub topic created for this Channel Services account or integrator. If there are no service accounts left with subscriber privileges, this deletes the topic. You can call integrators.listSubscribers to check for these accounts.
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: The topic name that unregistered the service email address. Returns a success response if the service email address wasn't registered with the topic.
HTTP request
POST https://cloudchannel.googleapis.com/v1alpha1/{integrator=integrators/*}:unregisterSubscriber
[[["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 endpoint unregisters a service account from subscriber privileges on a Pub/Sub topic, potentially deleting the topic if no other service accounts have these privileges.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eintegrator\u003c/code\u003e or \u003ccode\u003eaccount\u003c/code\u003e path parameters are conditionally required, and the request body must include the \u003ccode\u003eserviceAccount\u003c/code\u003e to be unregistered.\u003c/p\u003e\n"],["\u003cp\u003ePossible errors include \u003ccode\u003ePERMISSION_DENIED\u003c/code\u003e, \u003ccode\u003eINVALID_ARGUMENT\u003c/code\u003e, \u003ccode\u003eNOT_FOUND\u003c/code\u003e, \u003ccode\u003eINTERNAL\u003c/code\u003e, and \u003ccode\u003eUNKNOWN\u003c/code\u003e, each corresponding to different issues.\u003c/p\u003e\n"],["\u003cp\u003eA successful request returns the topic name that the service account was unregistered from, or indicates success if the service account wasn't registered, and it will return an instance of \u003ccode\u003eUnregisterSubscriberResponse\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe endpoint utilizes \u003ccode\u003ePOST\u003c/code\u003e requests via HTTP, and is also authenticated with the \u003ccode\u003ehttps://www.googleapis.com/auth/apps.order\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: integrators.unregisterSubscriber\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUnregisters a service account with subscriber privileges on the Pub/Sub topic created for this Channel Services account or integrator. If there are no service accounts left with subscriber privileges, this deletes the topic. You can call integrators.listSubscribers to check for these accounts.\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: The topic name that unregistered the service email address. Returns a success response if the service email address wasn't registered with the topic.\n\n### HTTP request\n\n`POST https://cloudchannel.googleapis.com/v1alpha1/{integrator=integrators/*}:unregisterSubscriber`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nIf successful, the response body contains an instance of [UnregisterSubscriberResponse](/channel/docs/reference/rest/v1alpha1/UnregisterSubscriberResponse).\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)."]]
