- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
Initiates a channel partner link between a distributor and a reseller, or between resellers in an n-tier reseller channel. Invited partners need to follow the inviteLinkUri provided in the response to accept. After accepting the invitation, a link is set up between the two parties. You must be a distributor to call this method.
Possible error codes:
- PERMISSION_DENIED: The reseller account making the request is different from the reseller account in the API request.
- INVALID_ARGUMENT: Required request parameters are missing or invalid.
- ALREADY_EXISTS: The ChannelPartnerLink sent in the request already exists.
- NOT_FOUND: No Cloud Identity customer exists for provided domain.
- 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 new ChannelPartnerLink resource.
HTTP request
POST https://cloudchannel.googleapis.com/v1alpha1/{parent=accounts/*}/channelPartnerLinks
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
parent |
Required. Create a channel partner link for the provided reseller account's resource name. Parent uses the format: accounts/{account_id} |
Query parameters
| Parameters | |
|---|---|
domain |
Optional. The invited partner's domain. Either domain or channelPartnerLink.reseller_cloud_identity_id can be used to create a link. Deprecated: Use |
Request body
The request body contains an instance of ChannelPartnerLink.
Response body
If successful, the response body contains a newly created instance of ChannelPartnerLink.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/apps.order
For more information, see the Authentication Overview.