Cloud Channel API

Service: cloudchannel.googleapis.com

To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery documents:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://cloudchannel.googleapis.com

REST Resource: v1alpha1.accounts

Methods
checkCloudIdentityAccountsExist POST /v1alpha1/{parent=accounts/*}:checkCloudIdentityAccountsExist
Confirms the existence of Cloud Identity accounts based on the domain and if the Cloud Identity accounts are owned by the reseller.
listSubscribers GET /v1alpha1/{account=accounts/*}:listSubscribers
Lists service accounts with subscriber privileges on the Cloud Pub/Sub topic created for this Channel Services account.
listTransferableOffers POST /v1alpha1/{parent=accounts/*}:listTransferableOffers
List TransferableOffers of a customer based on Cloud Identity ID or Customer Name in the request.
listTransferableSkus POST /v1alpha1/{parent=accounts/*}:listTransferableSkus
List TransferableSkus of a customer based on the Cloud Identity ID or Customer Name in the request.
register POST /v1alpha1/{account=accounts/*}:register
Registers a service account with subscriber privileges on the Cloud Pub/Sub topic for this Channel Services account.
unregister POST /v1alpha1/{account=accounts/*}:unregister
Unregisters a service account with subscriber privileges on the Cloud Pub/Sub topic created for this Channel Services account.

REST Resource: v1alpha1.accounts.channelPartnerLinks.customers

Methods
create POST /v1alpha1/{parent=accounts/*/channelPartnerLinks/*}/customers
Creates a new Customer resource under the reseller or distributor account.
delete DELETE /v1alpha1/{name=accounts/*/channelPartnerLinks/*/customers/*}
Deletes the given Customer permanently.
get GET /v1alpha1/{name=accounts/*/channelPartnerLinks/*/customers/*}
Returns the requested Customer resource.
import POST /v1alpha1/{parent=accounts/*/channelPartnerLinks/*}/customers:import
Imports a Customer from the Cloud Identity associated with the provided Cloud Identity ID or domain before a TransferEntitlements call.
list GET /v1alpha1/{parent=accounts/*/channelPartnerLinks/*}/customers
List Customers.
patch PATCH /v1alpha1/{customer.name=accounts/*/channelPartnerLinks/*/customers/*}
Updates an existing Customer resource for the reseller or distributor.

REST Resource: v1alpha1.accounts.customers

Methods
create POST /v1alpha1/{parent=accounts/*}/customers
Creates a new Customer resource under the reseller or distributor account.
delete DELETE /v1alpha1/{name=accounts/*/customers/*}
Deletes the given Customer permanently.
get GET /v1alpha1/{name=accounts/*/customers/*}
Returns the requested Customer resource.
import POST /v1alpha1/{parent=accounts/*}/customers:import
Imports a Customer from the Cloud Identity associated with the provided Cloud Identity ID or domain before a TransferEntitlements call.
list GET /v1alpha1/{parent=accounts/*}/customers
List Customers.
listPurchasableOffers GET /v1alpha1/{customer=accounts/*/customers/*}:listPurchasableOffers

Lists the following:

  • Offers that you can purchase for a customer.
listPurchasableSkus GET /v1alpha1/{customer=accounts/*/customers/*}:listPurchasableSkus

Lists the following:

  • SKUs that you can purchase for a customer
  • SKUs that you can upgrade or downgrade for an entitlement.
patch PATCH /v1alpha1/{customer.name=accounts/*/customers/*}
Updates an existing Customer resource for the reseller or distributor.
provisionCloudIdentity POST /v1alpha1/{customer=accounts/*/customers/*}:provisionCloudIdentity
Creates a Cloud Identity for the given customer using the customer's information, or the information provided here.
transferEntitlements POST /v1alpha1/{parent=accounts/*/customers/*}:transferEntitlements
Transfers customer entitlements to new reseller.
transferEntitlementsToGoogle POST /v1alpha1/{parent=accounts/*/customers/*}:transferEntitlementsToGoogle
Transfers customer entitlements from their current reseller to Google.

REST Resource: v1alpha1.accounts.customers.entitlements

Methods
activate POST /v1alpha1/{name=accounts/*/customers/*/entitlements/*}:activate
Activates a previously suspended entitlement.
assignChannelPartner POST /v1alpha1/{name=accounts/*/customers/*/entitlements/*}:assignChannelPartner
Assigns a Channel Partner to an Entitlement resource.
cancel POST /v1alpha1/{name=accounts/*/customers/*/entitlements/*}:cancel
Cancels a previously fulfilled entitlement.
changeOffer POST /v1alpha1/{name=accounts/*/customers/*/entitlements/*}:changeOffer
Updates the Offer for an existing customer entitlement.
changeParameters POST /v1alpha1/{name=accounts/*/customers/*/entitlements/*}:changeParameters
Change parameters of the entitlement.
changePlan
(deprecated)
POST /v1alpha1/{name=accounts/*/customers/*/entitlements/*}:changePlan
Updates the plan for an existing customer entitlement.
changeQuantity
(deprecated)
POST /v1alpha1/{name=accounts/*/customers/*/entitlements/*}:changeQuantity
Updates the quantity for existing seat-based entitlements.
changeRenewalSettings POST /v1alpha1/{name=accounts/*/customers/*/entitlements/*}:changeRenewalSettings
Updates the renewal settings for an existing customer entitlement.
changeSku
(deprecated)
POST /v1alpha1/{name=accounts/*/customers/*/entitlements/*}:changeSku
Updates the SKU for an existing customer entitlement.
create POST /v1alpha1/{parent=accounts/*/customers/*}/entitlements
Creates an entitlement for a customer.
get GET /v1alpha1/{name=accounts/*/customers/*/entitlements/*}
Returns the requested Entitlement resource.
list GET /v1alpha1/{parent=accounts/*/customers/*}/entitlements
Lists Entitlements belonging to a customer.
lookupOffer GET /v1alpha1/{entitlement=accounts/*/customers/*/entitlements/*}:lookupOffer
Returns the requested Offer resource.
startPaidService POST /v1alpha1/{name=accounts/*/customers/*/entitlements/*}:startPaidService
Starts paid service for a trial entitlement.
suspend POST /v1alpha1/{name=accounts/*/customers/*/entitlements/*}:suspend
Suspends a previously fulfilled entitlement.

REST Resource: v1alpha1.accounts.offers

Methods
list GET /v1alpha1/{parent=accounts/*}/offers
Lists the Offers the reseller can sell.

REST Resource: v1alpha1.operations

Methods
cancel POST /v1alpha1/{name=operations/**}:cancel
Starts asynchronous cancellation on a long-running operation.
delete DELETE /v1alpha1/{name=operations/**}
Deletes a long-running operation.
get GET /v1alpha1/{name=operations/*}
Gets the latest state of a long-running operation.
list GET /v1alpha1/{name}
Lists operations that match the specified filter in the request.

REST Resource: v1alpha1.products

Methods
list GET /v1alpha1/products
Lists the Products the reseller is authorized to sell.

REST Resource: v1alpha1.products.skus

Methods
list GET /v1alpha1/{parent=products/*}/skus
Lists the SKUs for a product the reseller is authorized to sell.

Service: cloudchannel.googleapis.com

To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.

Discovery document

A Discovery Document is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery documents:

Service endpoint

A service endpoint is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:

  • https://cloudchannel.googleapis.com

REST Resource: v1.accounts

Methods
checkCloudIdentityAccountsExist POST /v1/{parent=accounts/*}:checkCloudIdentityAccountsExist
Confirms the existence of Cloud Identity accounts based on the domain and if the Cloud Identity accounts are owned by the reseller.
listSubscribers GET /v1/{account=accounts/*}:listSubscribers
Lists service accounts with subscriber privileges on the Cloud Pub/Sub topic created for this Channel Services account.
listTransferableOffers POST /v1/{parent=accounts/*}:listTransferableOffers
List TransferableOffers of a customer based on Cloud Identity ID or Customer Name in the request.
listTransferableSkus POST /v1/{parent=accounts/*}:listTransferableSkus
List TransferableSkus of a customer based on the Cloud Identity ID or Customer Name in the request.
register POST /v1/{account=accounts/*}:register
Registers a service account with subscriber privileges on the Cloud Pub/Sub topic for this Channel Services account.
unregister POST /v1/{account=accounts/*}:unregister
Unregisters a service account with subscriber privileges on the Cloud Pub/Sub topic created for this Channel Services account.

REST Resource: v1.accounts.channelPartnerLinks.customers

Methods
create POST /v1/{parent=accounts/*/channelPartnerLinks/*}/customers
Creates a new Customer resource under the reseller or distributor account.
delete DELETE /v1/{name=accounts/*/channelPartnerLinks/*/customers/*}
Deletes the given Customer permanently.
get GET /v1/{name=accounts/*/channelPartnerLinks/*/customers/*}
Returns the requested Customer resource.
list GET /v1/{parent=accounts/*/channelPartnerLinks/*}/customers
List Customers.
patch PATCH /v1/{customer.name=accounts/*/channelPartnerLinks/*/customers/*}
Updates an existing Customer resource for the reseller or distributor.

REST Resource: v1.accounts.customers

Methods
create POST /v1/{parent=accounts/*}/customers
Creates a new Customer resource under the reseller or distributor account.
delete DELETE /v1/{name=accounts/*/customers/*}
Deletes the given Customer permanently.
get GET /v1/{name=accounts/*/customers/*}
Returns the requested Customer resource.
list GET /v1/{parent=accounts/*}/customers
List Customers.
listPurchasableOffers GET /v1/{customer=accounts/*/customers/*}:listPurchasableOffers

Lists the following:

  • Offers that you can purchase for a customer.
listPurchasableSkus GET /v1/{customer=accounts/*/customers/*}:listPurchasableSkus

Lists the following:

  • SKUs that you can purchase for a customer
  • SKUs that you can upgrade or downgrade for an entitlement.
patch PATCH /v1/{customer.name=accounts/*/customers/*}
Updates an existing Customer resource for the reseller or distributor.
provisionCloudIdentity POST /v1/{customer=accounts/*/customers/*}:provisionCloudIdentity
Creates a Cloud Identity for the given customer using the customer's information, or the information provided here.
transferEntitlements POST /v1/{parent=accounts/*/customers/*}:transferEntitlements
Transfers customer entitlements to new reseller.
transferEntitlementsToGoogle POST /v1/{parent=accounts/*/customers/*}:transferEntitlementsToGoogle
Transfers customer entitlements from their current reseller to Google.

REST Resource: v1.accounts.customers.entitlements

Methods
activate POST /v1/{name=accounts/*/customers/*/entitlements/*}:activate
Activates a previously suspended entitlement.
cancel POST /v1/{name=accounts/*/customers/*/entitlements/*}:cancel
Cancels a previously fulfilled entitlement.
changeOffer POST /v1/{name=accounts/*/customers/*/entitlements/*}:changeOffer
Updates the Offer for an existing customer entitlement.
changeParameters POST /v1/{name=accounts/*/customers/*/entitlements/*}:changeParameters
Change parameters of the entitlement.
changeRenewalSettings POST /v1/{name=accounts/*/customers/*/entitlements/*}:changeRenewalSettings
Updates the renewal settings for an existing customer entitlement.
create POST /v1/{parent=accounts/*/customers/*}/entitlements
Creates an entitlement for a customer.
get GET /v1/{name=accounts/*/customers/*/entitlements/*}
Returns the requested Entitlement resource.
list GET /v1/{parent=accounts/*/customers/*}/entitlements
Lists Entitlements belonging to a customer.
lookupOffer GET /v1/{entitlement=accounts/*/customers/*/entitlements/*}:lookupOffer
Returns the requested Offer resource.
startPaidService POST /v1/{name=accounts/*/customers/*/entitlements/*}:startPaidService
Starts paid service for a trial entitlement.
suspend POST /v1/{name=accounts/*/customers/*/entitlements/*}:suspend
Suspends a previously fulfilled entitlement.

REST Resource: v1.accounts.offers

Methods
list GET /v1/{parent=accounts/*}/offers
Lists the Offers the reseller can sell.

REST Resource: v1.operations

Methods
cancel POST /v1/{name=operations/**}:cancel
Starts asynchronous cancellation on a long-running operation.
delete DELETE /v1/{name=operations/**}
Deletes a long-running operation.
get GET /v1/{name=operations/**}
Gets the latest state of a long-running operation.
list GET /v1/{name}
Lists operations that match the specified filter in the request.

REST Resource: v1.products

Methods
list GET /v1/products
Lists the Products the reseller is authorized to sell.

REST Resource: v1.products.skus

Methods
list GET /v1/{parent=products/*}/skus
Lists the SKUs for a product the reseller is authorized to sell.