> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MatchTicket (JSON)

> MatchTicket (JSON)

# MatchTicket (JSON)

Un objet JSON représentant un ticket de jumelage, utilisé par les joueurs pour trouver d'autres joueurs au moyen du répertoire de sessions multijoueurs (MPSD).

L'objet JSON MatchTicket présente la spécification suivante.

| Membre | Type | Description |
| - | - | - |
| serviceConfig | GUID | Identificateur de configuration de service (SCID) de la session. |
| hopperName | string | Nom de la trémie dans laquelle ce ticket doit être placé. |
| giveUpDuration | entier signé 32 bits | Temps d'attente maximal (nombre entier de secondes). |
| preserveSession | énumération | Une valeur indiquant si la session doit être réutilisée comme session dans laquelle effectuer le jumelage. Les valeurs possibles sont « always » ou « never ». |
| ticketSessionRef | MultiplayerSessionReference | Objet **MultiplayerSessionReference** pour la session dans laquelle le joueur ou le groupe joue actuellement. Ce membre est toujours obligatoire. |
| ticketAttributes | tableau d'objets | Collection d'attributs et de valeurs fournis par l'utilisateur concernant les tickets des joueurs. |
| players | tableau d'objets | Collection d'objets player, chacun avec un conteneur de propriétés d'attributs fournis par l'utilisateur. |

## Exemple de syntaxe JSON

```json theme={null}
{
        "serviceConfig": "07617C5B-3423-4505-B6C6-10A16E1E5DDB",
        "hopperName": "TestHopper",
        "giveUpDuration": 10,
        "preserveSession": "never",
        "ticketSessionRef": {
        "scid": "AFFEABDF-0000-0000-0000-000000000001",
        "templateName": "TestTemplate",
        "sessionName": "5E551041-0000-0000-0000-000000000001"
    },
    "ticketAttributes": {
        "desiredMap": "Test Map",
        "desiredGameType": "Test GameType"
    },
    "players": [
        {
            "xuid": 123412345123,
            "playerAttributes": {
                "skill": 5,
                "ageRange": "teenager"
            }
        },
        {
          "xuid": 123412345124,
          "playerAttributes": {
              "skill": 15,
              "ageRange": "twenty-something"
          }
        }
      ]
    }
  
    
```

## Voir aussi

##### Parent

[Référence des objets JSON (JavaScript Object Notation)](https://docs.xbox.com/fr-CA/reference/live/rest/json/atoc-xboxlivews-reference-json.md)


## Related topics

- [URI de matchmaking](https://docs.xbox.com/fr-CA/reference/live/rest/uri/matchtickets/atoc-reference-matchtickets.md)
- [Cancel Matchmaking Ticket](https://docs.xbox.com/api-reference/matchmaking/cancel-matchmaking-ticket.md)
- [ticket_completed](https://docs.xbox.com/fr-CA/services/playfab/api-references/events/Matchmaking/ticket-completed.md)
- [Get Matchmaking Ticket](https://docs.xbox.com/api-reference/matchmaking/get-matchmaking-ticket.md)
- [MatchmakingTicketMatchMember.AttributesJSON](https://docs.xbox.com/fr-CA/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/MatchmakingTicketMatchMember/AttributesJSON.md)