*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Place

Représente un lieu Roblox.

Attributs

pathstring

Le chemin de ressource de l'endroit.

Format : universes/{universe_id}/places/{place_id}.

createTimestring

Sortie seule

La date et l'heure à laquelle le lieu a été créé. Ce string est formatée en tant que Timestamp.

updateTimestring

Sortie seule

La date et l'heure à laquelle le lieu a été mis à jour. Ce string est formatée en tant que Timestamp.

displayNamestring

Le nom de l'endroit.

descriptionstring

La description du lieu.

serverSizenumber

Le nombre maximum d'utilisateurs autorisés dans un seul serveur.

URL de base

https://apis.roblox.com

La ressource Place

{
  "path": "universes/123/places/123",
  "createTime": "2023-07-05T12:34:56Z",
  "updateTime": "2023-07-05T12:34:56Z",
  "displayName": "ROBLOX Battle [OPEN]",
  "description": "OPEN SOURCE! \n Feel free to check out how we made this game and ask us about it!",
  "serverSize": "integer"
}

Place

Obtenir une place

GET /cloud/v2/universes/{universe_id}/places/{place_id}

Obtient l'endroit spécifié.

RequêteParamètres du chemin

universe_idstring

Requis

L'ID de l'univers.

place_idstring

Requis

L'ID du lieu.

RéponsePlace

GET /cloud/v2/universes/{universe_id}/places/{place_id}

curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/places/{place_id}' \
  -H 'x-api-key: {your-api-key}'

Réponse

{
  "path": "universes/123/places/123",
  "createTime": "2023-07-05T12:34:56Z",
  "updateTime": "2023-07-05T12:34:56Z",
  "displayName": "ROBLOX Battle [OPEN]",
  "description": "OPEN SOURCE! \n Feel free to check out how we made this game and ask us about it!",
  "serverSize": "integer"
}

Place

Mise à jour de l'emplacement

PATCH /cloud/v2/universes/{universe_id}/places/{place_id}

Mise à jour de l'endroit spécifié.

Périmètres d'application

universe.place:write

RequêteParamètres du chemin

universe_idstring

Requis

L'ID de l'univers.

place_idstring

Requis

L'ID du lieu.

Paramètres de requête

updateMaskstring

La liste des champs à mettre à jour. Cette chaîne est formatée comme un FieldMask.

Corps de la requêtePlace

RéponsePlace

PATCH /cloud/v2/universes/{universe_id}/places/{place_id}

curl -L -X PATCH 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/places/{place_id}?updateMask={string}' \
  -H 'x-api-key: {your-api-key}' \
  -H 'Content-Type: application/json' \
  --data '{
  "displayName": "ROBLOX Battle [OPEN]",
  "description": "OPEN SOURCE! \n Feel free to check out how we made this game and ask us about it!",
  "serverSize": "integer"
}'

Réponse

{
  "path": "universes/123/places/123",
  "createTime": "2023-07-05T12:34:56Z",
  "updateTime": "2023-07-05T12:34:56Z",
  "displayName": "ROBLOX Battle [OPEN]",
  "description": "OPEN SOURCE! \n Feel free to check out how we made this game and ask us about it!",
  "serverSize": "integer"
}