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