# REST Resource: accounts.channelPartnerLinks

- [Resource: ChannelPartnerLink](https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.channelPartnerLinks#ChannelPartnerLink)
  - [JSON representation](https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.channelPartnerLinks#ChannelPartnerLink.SCHEMA_REPRESENTATION)
- [ChannelPartnerLinkState](https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.channelPartnerLinks#ChannelPartnerLinkState)
- [Methods](https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.channelPartnerLinks#METHODS_SUMMARY)

## Resource: ChannelPartnerLink

Entity representing a link between distributors and their indirect resellers in an n-tier resale channel.

| JSON representation |
|---|
| ``` { "name": string, "resellerCloudIdentityId": string, "linkState": enum (`https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.channelPartnerLinks#ChannelPartnerLinkState`), "inviteLinkUri": string, "createTime": string, "updateTime": string, "publicId": string, "channelPartnerCloudIdentityInfo": { object (`https://docs.cloud.google.com/channel/docs/reference/rest/v1/CloudIdentityInfo`) } } ``` |

| Fields ||
|---|---|
| `name` | `string` Output only. Resource name for the channel partner link, in the format accounts/{account_id}/channelPartnerLinks/{id}. |
| `resellerCloudIdentityId` | `string` Required. Cloud Identity ID of the linked reseller. |
| `linkState` | ``enum (`https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.channelPartnerLinks#ChannelPartnerLinkState`)`` Required. State of the channel partner link. |
| `inviteLinkUri` | `string` Output only. URI of the web page where partner accepts the link invitation. |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. Timestamp of when the channel partner link is created. Uses RFC 3339, where generated output is always Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `updateTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. Timestamp of when the channel partner link is updated. Uses RFC 3339, where generated output is always Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `publicId` | `string` Output only. Public identifier that a customer must use to generate a transfer token to move to this distributor-reseller combination. |
| `channelPartnerCloudIdentityInfo` | ``object (`https://docs.cloud.google.com/channel/docs/reference/rest/v1/CloudIdentityInfo`)`` Output only. Cloud Identity info of the channel partner (IR). |

## ChannelPartnerLinkState

ChannelPartnerLinkState represents state of a channel partner link.

| Enums ||
|---|---|
| `CHANNEL_PARTNER_LINK_STATE_UNSPECIFIED` | Not used. |
| `INVITED` | An invitation has been sent to the reseller to create a channel partner link. |
| `ACTIVE` | Status when the reseller is active. |
| `REVOKED` | Status when the reseller has been revoked by the distributor. |
| `SUSPENDED` | Status when the reseller is suspended by Google or distributor. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.channelPartnerLinks/create` | Initiates a channel partner link between a distributor and a reseller, or between resellers in an n-tier reseller channel. |
| ### `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.channelPartnerLinks/get` | Returns the requested `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.channelPartnerLinks#ChannelPartnerLink` resource. |
| ### `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.channelPartnerLinks/list` | List `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.channelPartnerLinks#ChannelPartnerLink`s belonging to a distributor. |
| ### `https://docs.cloud.google.com/channel/docs/reference/rest/v1/accounts.channelPartnerLinks/patch` | Updates a channel partner link. |