List TransferableOffers of a customer based on Cloud Identity ID or Customer Name in the request.
Use this method when a reseller gets the entitlement information of an unowned customer. The reseller should provide the customer's Cloud Identity ID or Customer Name.
Possible error codes:
PERMISSION_DENIED:
The customer doesn't belong to the reseller and has no auth token.
The customer provided incorrect reseller information when generating auth token.
The reseller account making the request is different from the reseller account in the query.
Required. The resource name of the reseller's account.
Request body
The request body contains data with the following structure:
JSON representation
{"pageSize": integer,"pageToken": string,"sku": string,"languageCode": string,"billingAccount": string,// Union field transferred_customer_identity can be only one of the following:"cloudIdentityId": string,"customerName": string// End of list of possible types for union field transferred_customer_identity.}
Fields
pageSize
integer
Requested page size. Server might return fewer results than requested. If unspecified, returns at most 100 offers. The maximum value is 1000; the server will coerce values above 1000.
Optional. The BCP-47 language code. For example, "en-US". The response will localize in the corresponding language code, if specified. The default value is "en-US".
billingAccount
string
Optional. The Billing Account to look up Offers for. Format: accounts/{account_id}/billingAccounts/{billing_account_id}.
This field is only relevant for multi-currency accounts. It should be left empty for single currency accounts.
Union field transferred_customer_identity. Specifies the identity of transferred customer. Either a cloud_identity_id of the customer or the customer name is required to look up transferrable Offers. transferred_customer_identity can be only one of the following:
cloudIdentityId
string
Customer's Cloud Identity ID
customerName
string
A reseller should create a customer and use the resource name of that customer here.
Offer with parameter constraints updated to allow the Transfer.
priceReferenceId
string
Optional. Price reference ID for the offer. Only for offers that require additional price information. Used to guarantee that the pricing is consistent between quoting the offer and placing the order.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-05-19 UTC."],[[["\u003cp\u003eThis endpoint retrieves a list of \u003ccode\u003eTransferableOffer\u003c/code\u003e resources for a specified customer and SKU, allowing resellers to view entitlement information for unowned customers.\u003c/p\u003e\n"],["\u003cp\u003eResellers must provide either the customer's Cloud Identity ID or Customer Name in the request body to identify the customer for whom the \u003ccode\u003eTransferableOffer\u003c/code\u003e resources are to be retrieved.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires specifying the reseller's account in the \u003ccode\u003eparent\u003c/code\u003e path parameter, as well as the target \u003ccode\u003esku\u003c/code\u003e in the request body, with optional parameters such as \u003ccode\u003epageSize\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, \u003ccode\u003elanguageCode\u003c/code\u003e, and \u003ccode\u003ebillingAccount\u003c/code\u003e available.\u003c/p\u003e\n"],["\u003cp\u003ePossible error responses include \u003ccode\u003ePERMISSION_DENIED\u003c/code\u003e, which may occur if the customer does not belong to the reseller, or \u003ccode\u003eINVALID_ARGUMENT\u003c/code\u003e if required request parameters are missing or invalid.\u003c/p\u003e\n"],["\u003cp\u003eThe response body contains a list of \u003ccode\u003eTransferableOffer\u003c/code\u003e resources, each detailing an offer that can be used for transfer, and a \u003ccode\u003enextPageToken\u003c/code\u003e for retrieving subsequent pages of results if applicable.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.listTransferableOffers\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListTransferableOffersResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [TransferableOffer](#TransferableOffer)\n - [JSON representation](#TransferableOffer.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nList [TransferableOffer](/channel/docs/reference/rest/v1alpha1/accounts/listTransferableOffers#TransferableOffer)s of a customer based on Cloud Identity ID or Customer Name in the request.\n\nUse this method when a reseller gets the entitlement information of an unowned customer. The reseller should provide the customer's Cloud Identity ID or Customer Name.\n\nPossible error codes:\n\n- PERMISSION_DENIED:\n - The customer doesn't belong to the reseller and has no auth token.\n - The customer provided incorrect reseller information when generating auth token.\n - The reseller account making the request is different from the reseller account in the query.\n - The reseller is not authorized to transact on this Product. See \u003chttps://support.google.com/channelservices/answer/9759265\u003e\n- INVALID_ARGUMENT: Required request parameters are missing or invalid.\n\nReturn value: List of [TransferableOffer](/channel/docs/reference/rest/v1alpha1/accounts/listTransferableOffers#TransferableOffer) for the given customer and SKU.\n\n### HTTP request\n\n`POST https://cloudchannel.googleapis.com/v1alpha1/{parent=accounts/*}:listTransferableOffers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nResponse message for [CloudChannelService.ListTransferableOffers](/channel/docs/reference/rest/v1alpha1/accounts/listTransferableOffers#google.cloud.channel.v1alpha1.CloudChannelService.ListTransferableOffers).\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/apps.order`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\nTransferableOffer\n-----------------\n\nTransferableOffer represents an Offer that can be used in Transfer. Read-only."]]