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/v1alpha1/{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

Response Message for accounts.register.

If successful, the response body contains data with the following structure:

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.