> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sparkle.bot/llms.txt
> Use this file to discover all available pages before exploring further.
# Channel Points
> Gérez les points de chaîne et les récompenses personnalisées de votre chaîne Twitch
L'objet `channelPoints` inclus plusieurs méthodes pour gérer les points de chaîne et les récompenses personnalisées sur votre chaîne Twitch.
## Actions
### `getCustomRewards`
Récupère la liste des récompenses personnalisées de la chaîne.
```javascript theme={null}
const rewards = await ctx.twitch.channelPoints.getCustomRewards()
```
**Type de retour**
La méthode retourne un tableau de [CustomReward](#customreward).
### `getCustomRewardsByIds`
Récupère les récompenses personnalisées par ID.
```javascript theme={null}
const rewardIds = ["reward_id_1", "reward_id_2"]
const rewards = await ctx.twitch.channelPoints.getCustomRewardsByIds(rewardIds)
```
Retourne un tableau de [CustomReward](#customreward).
**Arguments**
Un tableau d'identifiants de récompenses personnalisées.
### `getCustomRewardById`
Récupère une récompense personnalisée par ID.
```javascript theme={null}
const rewardId = "reward_id"
const reward = await ctx.twitch.channelPoints.getCustomRewardById(rewardId)
```
Retourne un objet [CustomReward](#customreward).
**Arguments**
L'ID de la récompense personnalisée à récupérer.
### `createCustomReward`
Crée une nouvelle récompense personnalisée sur la chaîne.
```javascript theme={null}
const data = {
title: "Titre de la récompense",
cost: 100,
}
const reward = await ctx.twitch.channelPoints.createCustomReward(data)
```
Retourne un objet [CustomReward](#customreward).
**Arguments**
Les données de la récompense personnalisée à créer.
### `updateCustomReward`
Met à jour une récompense personnalisée existante.
```javascript theme={null}
const rewardId = "reward_id"
const data = {
title: "Nouveau titre de la récompense",
cost: 150,
}
const updatedReward = await ctx.twitch.channelPoints.updateCustomReward(
rewardId,
data,
)
```
Retourne un objet [CustomReward](#customreward).
**Arguments**
L'ID de la récompense personnalisée à mettre à jour.
Les données mises à jour de la récompense personnalisée.
### `deleteCustomReward`
Supprime une récompense personnalisée de la chaîne.
```javascript theme={null}
const rewardId = "reward_id"
await ctx.twitch.channelPoints.deleteCustomReward(rewardId)
```
**Arguments**
L'ID de la récompense personnalisée à supprimer.
### `getRedemptions`
Récupère les rédemptions de récompenses personnalisées pour une récompense donnée.
```javascript theme={null}
const rewardId = "reward_id"
const status = "FULFILLED"
const filter = {
sort: "NEWEST",
maxRedemptions: 10,
}
const redemptions = await ctx.twitch.channelPoints.getRedemptions(
rewardId,
status,
filter,
)
```
**Arguments**
L'ID de la récompense personnalisée.
Le statut des rédemptions à récupérer ("FULFILLED", "CANCELED", "UNFULFILLED",
"PARTIALLY\_FULFILLED").
{" "}
(optionnel): Les filtres supplémentaires pour les rédemptions.
**Type de retour**
La méthode retourne un objet contenant les données des rédemptions et un curseur de pagination.
## Types
### `CustomReward`
L'identifiant de la récompense personnalisée.
La couleur de fond de la récompense.
Indique si la récompense est activée.
Le coût de la récompense en points de chaîne.
Le titre de la récompense.
Le texte de la demande associée à la récompense.
Indique si une entrée utilisateur est requise.
Le nombre maximal de rédemptions par diffusion.
Le nombre maximal de rédemptions par utilisateur par diffusion.
Le temps de refroidissement global en secondes.
Indique si la récompense est en pause.
Indique si la récompense est en stock.
Le nombre de rédemptions pendant cette diffusion.
Indique si les rédemptions sont automatiquement satisfaites.
La date d'expiration du temps de refroidissement.
### `CustomRewardRedemption`
L'identifiant de la rédemption de récompense personnalisée.
L'identifiant de l'utilisateur qui a effectué la rédemption.
Le nom d'utilisateur de l'utilisateur qui a effectué la rédemption.
Le nom d'affichage de l'utilisateur qui a effectué la rédemption.
L'entrée utilisateur associée à la rédemption.
Indique si la rédemption a été satisfaite.
Indique si la rédemption a été annulée.
La date de la rédemption.
L'identifiant de la récompense associée à la rédemption.
Le titre de la récompense associée à la rédemption.
Le texte de la demande associée à la récompense.
Le coût de la récompense associée à la rédemption.