Method: accounts.register

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

string

Required. Resource name of the account.

Request body

The request body contains data with the following structure:

JSON representation
{
  "serviceAccount": string
}
Fields
serviceAccount

string

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

string

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.