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 accounts.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/v1/{account=accounts/*}:unregister
[[["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 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\u003ePOST\u003c/code\u003e HTTP request is made to \u003ccode\u003ehttps://cloudchannel.googleapis.com/v1/{account=accounts/*}:unregister\u003c/code\u003e, using gRPC Transcoding syntax, and requires either an \u003ccode\u003eaccount\u003c/code\u003e or \u003ccode\u003eintegrator\u003c/code\u003e path parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe request body, containing the \u003ccode\u003eserviceAccount\u003c/code\u003e and optional \u003ccode\u003eintegrator\u003c/code\u003e, is formatted as JSON, and specifies which service account to unregister.\u003c/p\u003e\n"],["\u003cp\u003eA successful response returns an instance of \u003ccode\u003eUnregisterSubscriberResponse\u003c/code\u003e, or a success response if the account was not previously registered, while errors may include \u003ccode\u003ePERMISSION_DENIED\u003c/code\u003e, \u003ccode\u003eINVALID_ARGUMENT\u003c/code\u003e, \u003ccode\u003eNOT_FOUND\u003c/code\u003e, or internal server errors.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this API requires the \u003ccode\u003ehttps://www.googleapis.com/auth/apps.order\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.unregister\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 accounts.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/v1/{account=accounts/*}:unregister`\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/v1/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)."]]
