Registers a service account with subscriber privileges on the Cloud Pub/Sub topic for this Channel Services account. After you create a subscriber, you get the events through SubscriberEvent
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.
- 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 with the registered service email address.
HTTP request
POST https://cloudchannel.googleapis.com/v1/{account=accounts/*}:register
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
account |
Required. Resource name of the account. |
Request body
The request body contains data with the following structure:
| JSON representation |
|---|
{ "serviceAccount": string } |
| Fields | |
|---|---|
serviceAccount |
Required. Service account that provides subscriber access to the registered topic. |
Response body
If successful, the response body contains data with the following structure:
Response Message for accounts.register.
| JSON representation |
|---|
{ "topic": string } |
| Fields | |
|---|---|
topic |
Name of the topic the subscriber will listen to. |
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/apps.order
For more information, see the Authentication Overview.