*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

UserRestriction

Representa una restricción para un usuario.

  • RUTAS DE RECURSOS
  • /cloud/v2/universes/{universe_id}/user-restrictions
  • /cloud/v2/universes/{universe_id}/places/{place_id}/user-restrictions

Atributos

pathstring

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}.
updateTimestring
Solo salida

La fecha y hora en que se actualizó por última vez la restricción de usuarios. Esta cadena está formateada como Timestamp.

userstring
Solo salida

El usuario afectado.

gameJoinRestrictionobject

El usuario está prohibido del universo o lugar padre.

URL base

https://apis.roblox.com
El recurso UserRestriction

{
"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
}
}

UserRestriction

List User Restrictions
Beta

GET /cloud/v2/universes/{universe_id}/user-restrictions

Lista las restricciones de usuario para usuarios que alguna vez hayan sido prohibidos en un universo o en un lugar específico.

Ámbitos
universe.user-restriction:read
SolicitudParámetros de ruta
universe_idstring
Obligatorio

La identificación del universo.

Parámetros de consulta
maxPageSizenumber

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.

pageTokenstring

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.

Respuesta

Una lista de restricciones de usuario en la coleccionespadre.

userRestrictionsarray<UserRestriction>

Las restricciones de usuario del universo o lugar especificado.

nextPageTokenstring

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.

GET /cloud/v2/universes/{universe_id}/user-restrictions

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}'
Respuesta

{
"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"
}

UserRestriction

Get User Restriction
Beta

GET /cloud/v2/universes/{universe_id}/user-restrictions/{user_restriction_id}

Obtener la restricción de usuario.

Ámbitos
universe.user-restriction:read
SolicitudParámetros de ruta
universe_idstring
Obligatorio

La identificación del universo.

user_restriction_idstring
Obligatorio

El ID de restricción de usuario.

GET /cloud/v2/universes/{universe_id}/user-restrictions/{user_restriction_id}

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}'
Respuesta

{
"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
}
}

UserRestriction

Update User Restriction
Beta

PATCH /cloud/v2/universes/{universe_id}/user-restrictions/{user_restriction_id}

Actualizar la restricción de usuario.

Ámbitos
universe.user-restriction:write
SolicitudParámetros de ruta
universe_idstring
Obligatorio

La identificación del universo.

user_restriction_idstring
Obligatorio

El ID de restricción de usuario.

Parámetros de consulta
updateMaskstring

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.

idempotencyKey.keystring

La clave única para usar para la idempotencia.

idempotencyKey.firstSentstring

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.

Solicitar cuerpoUserRestriction
PATCH /cloud/v2/universes/{universe_id}/user-restrictions/{user_restriction_id}

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
}
}'
Respuesta

{
"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
}
}

UserRestriction

List User Restriction Logs
Beta

GET /cloud/v2/universes/{universe_id}/user-restrictions:listLogs

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.

Ámbitos
universe.user-restriction:read
SolicitudParámetros de ruta
universe_idstring
Obligatorio

La identificación del universo.

Parámetros de consulta
maxPageSizenumber

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.

pageTokenstring

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.

filterstring

Este campo se puede configurar para filtrar los registros devueltos.

El campo filter admite un número muy pequeño de CEL:

  • user
  • place
  • El operador de comparación == está disponible.
  • El operador lógico && también se admite.

Como ejemplo, filtrar para un usuario y un lugar toma la forma filter="user == 'users/123'" && "place == 'places/456'".

Respuesta

Devuelve una lista de registros de cambios aplicados a los recursos de restricción de usuario.

logsarray<object>

Los registros de restricciones de usuario del universo especificado.

nextPageTokenstring

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.

GET /cloud/v2/universes/{universe_id}/user-restrictions:listLogs

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}'
Respuesta

{
"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"
}