---
title: API de cadeaux
slug: world-sdk-guide-fr/api-de-cadeaux
docTags: 
createdAt: 2024-09-02T08:34:13.134Z
---

Vous pouvez utiliser l'API de cadeaux pour offrir des vêtements à d'autres utilisateurs dans le monde ZEPETO.

Cependant, lors de l'utilisation de l'API, les biens de l'expéditeur seront déduits.



## Installer

Fenêtre → Gestionnaire de paquets → Paquet ZEPETO.World Veuillez d'abord installer la version 1.21.14 ou supérieure.

Ensuite, veuillez installer le paquet ‘ZEPETO.Module’ avec une version de 1.0.7 ou supérieure.

Assurez-vous que l'application ZEPETO fonctionne avec la version 3.46.000 ou supérieure.

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-SCGjvJHEAi76UkoHHXYW_-20240904-102409.png)



## API de cadeaux

Pour utiliser l'API de cadeaux, ajoutez l'instruction d'importation ci-dessous.

```typescript
import { GiftBackgroundType, ShopService, ItemGiftResponse } from 'ZEPETO.Module.Shop';
```



Si vous êtes intéressé par l'API de Gifting, consultez la documentation :

:::hint{type="info"}
**📘 **Veuillez consulter le guide suivant. \[[API ZEPETO.Module.Shop](https://developer.zepeto.me/docs/module/namespaces/ZEPETO_Module_Shop)]
:::



:::hint{type="danger"}
- Dans l'éditeur Unity, vous pouvez tester à la fois les cas de succès et d'échec. Même si le cadeau est réussi, il ne déduira aucune monnaie, et le cadeau ne sera pas livré au destinataire.
- Lors des tests mobiles via des codes QR ou des liens de test, les transactions réussies entraîneront une déduction réelle de la monnaie et le cadeau sera livré au destinataire.
:::



## Exemple d'utilisation

- Veuillez ajouter un bouton Envoyer un cadeau au Canvas.
- Veuillez écrire le code d'exemple comme ci-dessous.

```typescript
import { ZepetoScriptBehaviour } from 'ZEPETO.Script';
import { GiftBackgroundType, ShopService, ItemGiftResponse } from 'ZEPETO.Module.Shop';
import { Button } from 'UnityEngine.UI';
import { ErrorCode } from 'ZEPETO.Module';
 
export default class SendGift extends ZepetoScriptBehaviour {
 
    public itemId : string;
    public targetUserId : string;
    public sendGiftButton : Button;
 
    Start() {
        this.sendGiftButton.onClick.AddListener(()=>{
            ShopService.ShowGiftPopup(
                this.itemId,
                this.targetUserId,
                GiftBackgroundType.Type01,
                "Salut, ceci est pour vous !",
                (response: ItemGiftResponse) => {  // callback onComplete
                    console.log(`Cadeau envoyé avec succès ! Solde ZEPETO Coin ${response.coin}, Solde ZEM ${response.zem}`);
                },
                (error: ErrorCode) => {  // callback onFailure
                    console.error("Erreur lors de l'envoi du cadeau:", error);
                }
            );
        });
    }
}
```



- Après avoir écrit le script, connectez le bouton dans l'inspecteur et entrez l'ID utilisateur et l'ID d'article de la personne qui recevra le cadeau.

:::hint{type="info"}
**📘 **Veuillez vous référer au guide suivant sur la façon d'obtenir l'UserId du joueur Zepeto. \[[ZEPETO Player](docId\:CShSh6driO-eCCNeXl59U)]
:::



- Pour tester les cas de succès ou d'échec, créez un code QR puis testez-le sur votre appareil mobile.
- Cependant, veuillez noter que les biens de l'expéditeur seront déduits.



### Lorsque l'envoi d'un cadeau est réussi

- Lorsque vous cliquez sur le bouton, une interface utilisateur contextuelle pour envoyer un cadeau apparaîtra.

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-3MUIdRSuqF0IHLlTLP8s7-20240904-102409.png)



- Si le cadeau est envoyé avec succès, une interface utilisateur Toast apparaîtra pour indiquer le succès, et le script d'exemple générera un journal

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-Vf1otjwZXmf93sv8CRJlA-20240904-102409.png)



![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-b1LZQ5DbQd9JpXX1av_uO-20240904-102409.png)



- De plus, un cadeau est arrivé pour targetUser.

::Image[]{src="https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-SujWd6C1VsYM0lNIAcRDq-20240904-102409.jpg" size="60" width="865" height="1068" position="center" showCaption="false"}



### Lorsque l'envoi d'un cadeau échoue

- Si le cas correspond à ErrorCode, un message d'erreur sera affiché dans l'interface Toast, et le script d'exemple affichera le code d'erreur correspondant.

![](https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-zAFMZdiur9v6Cf7LN_97C-20240904-102410.png)



::Image[]{src="https://api.archbee.com/api/optimize/fCt3n1oCa8rgNJ8fw9I2N-_k8_ckg4so3bvNO6LLZBc-20240904-102409.png" size="50" width="290" height="60" position="center" showCaption="false"}