Cloud Channel API (cloudchannel:v1)

2024-10-25

3 new methods | 1 updated method

Additions

    Methods
  • cloudchannel.integrators.registerSubscriber

      Path : v1/{+integrator}:registerSubscriber

      Flat Path : v1/integrators/{integratorsId}:registerSubscriber

      HTTP Method : POST

      Parameters :

        integrator

          Description : Optional. Resource name of the integrator. Required if account is not provided. Otherwise, leave this field empty/unset.

          Pattern : ^integrators/[^/]+$

          Location : path

          Required : Yes

          Type : string

      Parameter Order : integrator

      Scopes : https://www.googleapis.com/auth/apps.order

      Description : 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.

  • cloudchannel.integrators.unregisterSubscriber

      Path : v1/{+integrator}:unregisterSubscriber

      Flat Path : v1/integrators/{integratorsId}:unregisterSubscriber

      HTTP Method : POST

      Parameters :

        integrator

          Description : Optional. Resource name of the integrator. Required if account is not provided. Otherwise, leave this field empty/unset.

          Pattern : ^integrators/[^/]+$

          Location : path

          Required : Yes

          Type : string

      Parameter Order : integrator

      Scopes : https://www.googleapis.com/auth/apps.order

      Description : 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 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.

  • cloudchannel.integrators.listSubscribers

      Path : v1/{+integrator}:listSubscribers

      Flat Path : v1/integrators/{integratorsId}:listSubscribers

      HTTP Method : GET

      Parameters :

        integrator

          Description : Optional. Resource name of the integrator. Required if account is not provided. Otherwise, leave this field empty/unset.

          Pattern : ^integrators/[^/]+$

          Location : path

          Required : Yes

          Type : string

        account

          Description : Optional. Resource name of the account. Required if integrator is not provided. Otherwise, leave this field empty/unset.

          Location : query

          Type : string

        pageSize

          Description : Optional. The maximum number of service accounts to return. The service may return fewer than this value. If unspecified, returns at most 100 service accounts. The maximum value is 1000; the server will coerce values above 1000.

          Location : query

          Type : integer

          Format : int32

        pageToken

          Description : Optional. A page token, received from a previous `ListSubscribers` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListSubscribers` must match the call that provided the page token.

          Location : query

          Type : string

      Parameter Order : integrator

      Scopes : https://www.googleapis.com/auth/apps.order

      Description : Lists service accounts with subscriber privileges on the Pub/Sub topic created for this Channel Services account or integrator. 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: A list of service email addresses.

Updates

    Methods
  • cloudchannel.accounts.listSubscribers

      Parameters :

        integrator

          Description : Optional. Resource name of the integrator. Required if account is not provided. Otherwise, leave this field empty/unset.

          Location : query

          Type : string