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
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
account |
Optional. Resource name of the account. Required if integrator is not provided. Otherwise, leave this field empty/unset. |
Request body
The request body contains data with the following structure:
| JSON representation |
|---|
{ "serviceAccount": string, "integrator": string } |
| Fields | |
|---|---|
service |
Required. Service account to unregister from subscriber access to the topic. |
integrator |
Optional. Resource name of the integrator. Required if account is not provided. Otherwise, leave this field empty/unset. |
Response body
If successful, the response body contains an instance of UnregisterSubscriberResponse.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/apps.order
For more information, see the Authentication Overview.