El camino de recursos de la restricción de usuario.
Formatos:
- universes/{universe_id}/user-restrictions/{user_restriction_id}
- universes/{universe_id}/places/{place_id}/user-restrictions/{user_restriction_id}.
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
Representa una restricción para un usuario.
El camino de recursos de la restricción de usuario.
Formatos:
La fecha y hora en que se actualizó por última vez la restricción de usuarios. Esta cadena está formateada como Timestamp.
El usuario afectado.
El usuario está prohibido del universo o lugar padre.
https://apis.roblox.com
{
"path": "universes/123/user-restrictions/123",
"updateTime": "2023-07-05T12:34:56Z",
"user": "users/156",
"gameJoinRestriction": {
"active": true,
"startTime": "2023-07-05T12:34:56Z",
"duration": "3s",
"privateReason": "some private reason",
"displayReason": "some display reason",
"excludeAltAccounts": true,
"inherited": true
}
}
Lista las restricciones de usuario para usuarios que alguna vez hayan sido prohibidos en un universo o en un lugar específico.
La identificación del universo.
El número máximo de restricciones de usuario para devolver.El servicio podría devolver menos que este valor.Si no se especifica, se devuelven un máximo de 10 restricciones de usuario.El valor máximo es 100 y los valores más altos se establecen en 100.
Una ficha de página, recibida de una llamada anterior, para recuperar una página posterior.
Al paginar, todos los demás parámetros proporcionados a la llamada siguiente deben coincidir con la llamada que proporcionó el token de página.
Una lista de restricciones de usuario en la coleccionespadre.
Las restricciones de usuario del universo o lugar especificado.
Una token que puedes enviar como parámetro pageToken para recuperar la siguiente página. Si este campo se omite, no hay páginas posteriores.
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/user-restrictions?maxPageSize=10&pageToken={string}' \
-H 'x-api-key: {your-api-key}'
{
"userRestrictions": [
{
"path": "universes/123/user-restrictions/123",
"updateTime": "2023-07-05T12:34:56Z",
"user": "users/156",
"gameJoinRestriction": {
"active": true,
"startTime": "2023-07-05T12:34:56Z",
"duration": "3s",
"privateReason": "some private reason",
"displayReason": "some display reason",
"excludeAltAccounts": true,
"inherited": true
}
}
],
"nextPageToken": "string"
}
Obtener la restricción de usuario.
La identificación del universo.
El ID de restricción de usuario.
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/user-restrictions/{user_restriction_id}' \
-H 'x-api-key: {your-api-key}'
{
"path": "universes/123/user-restrictions/123",
"updateTime": "2023-07-05T12:34:56Z",
"user": "users/156",
"gameJoinRestriction": {
"active": true,
"startTime": "2023-07-05T12:34:56Z",
"duration": "3s",
"privateReason": "some private reason",
"displayReason": "some display reason",
"excludeAltAccounts": true,
"inherited": true
}
}
Actualizar la restricción de usuario.
La identificación del universo.
El ID de restricción de usuario.
La lista de campos para actualización.
El campo game_join_restriction debe actualizarse atómicamente; las máscaras de campo que se indexan en game_join_restriction (como "game_join_restriction.active" ) no se admiten. Esta cadena está formateada como Timestamp.
La clave única para usar para la idempotencia.
La marca de tiempo en la que se envió la primera solicitud.
Si esto está más en el pasado que la vida útil de la clave de idempotencia (que puede exceder la vida útil mínima anotada), el servidor debe devolver un error. Esta cadena está formateada como Timestamp.
curl -L -X PATCH 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/user-restrictions/{user_restriction_id}?updateMask={string}&idempotencyKey.key={string}&idempotencyKey.firstSent={string}' \
-H 'x-api-key: {your-api-key}' \
-H 'Content-Type: application/json' \
--data '{
"gameJoinRestriction": {
"active": true,
"duration": "3s",
"privateReason": "some private reason",
"displayReason": "some display reason",
"excludeAltAccounts": true
}
}'
{
"path": "universes/123/user-restrictions/123",
"updateTime": "2023-07-05T12:34:56Z",
"user": "users/156",
"gameJoinRestriction": {
"active": true,
"startTime": "2023-07-05T12:34:56Z",
"duration": "3s",
"privateReason": "some private reason",
"displayReason": "some display reason",
"excludeAltAccounts": true,
"inherited": true
}
}
Lista los cambios a los recursos de restricción de usuario dentro de un universo dado. Esto incluye tanto restricciones a nivel de universo como a nivel de lugar.
Para los registros de restricción a nivel de universo, el campo place estará vacío.
La identificación del universo.
El número máximo de registros de restricción de usuario para devolver.El servicio puede devolver menos que este valor.Si no se especifica, se devuelven un máximo de 10 registros de restricción de usuario.El valor máximo es 100 y los valores más altos se establecen en 100.
Una ficha de página, recibida de una llamada anterior, para recuperar una página posterior.
Al paginar, todos los demás parámetros proporcionados a la llamada siguiente deben coincidir con la llamada que proporcionó el token de página.
Este campo se puede configurar para filtrar los registros devueltos.
El campo filter admite un número muy pequeño de CEL:
Como ejemplo, filtrar para un usuario y un lugar toma la forma filter="user == 'users/123'" && "place == 'places/456'".
Devuelve una lista de registros de cambios aplicados a los recursos de restricción de usuario.
Los registros de restricciones de usuario del universo especificado.
Una token que puedes enviar como parámetro pageToken para recuperar la siguiente página. Si este campo se omite, no hay páginas posteriores.
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/user-restrictions:listLogs?maxPageSize=10&pageToken={string}&filter={string}' \
-H 'x-api-key: {your-api-key}'
{
"logs": [
{
"user": "users/156",
"place": "places/456",
"moderator": {
"robloxUser": "users/156"
},
"createTime": "2023-07-05T12:34:56Z",
"active": true,
"startTime": "2023-07-05T12:34:56Z",
"duration": "3s",
"privateReason": "some private reason",
"displayReason": "some display reason",
"restrictionType": {
"gameJoinRestriction": {}
},
"excludeAltAccounts": true
}
],
"nextPageToken": "string"
}