> ## 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.

# Grupos

> Administra los grupos de entidades de PlayFab y sus roles, miembros, invitaciones, solicitudes y bloqueos.

La familia de comandos `playfab group` es experimental. Su interfaz de la CLI puede cambiar
o quitarse en función de los comentarios.

Administra los grupos de entidades de PlayFab y sus roles, miembros, invitaciones, solicitudes y
bloqueos, y enumera los grupos a los que pertenece una entidad.

La mayoría de los comandos actúan sobre un grupo con `--group-id`; `group get` puede usar `--group-name`
en su lugar. Pasa `--entity-id` y `--entity-type` juntos, como `--entity-type
title_player_account`. Para un jugador, pasa su identificador de cuenta de jugador de título, no su identificador de cuenta
de jugador maestra; [`playfab player account get`](https://docs.xbox.com/es/tools/xbox-cli/commands/playfab/player) lo devuelve como
`UserInfo.TitleInfo.TitlePlayerAccount.Id`.

`group delete` y `group role delete` preguntan primero en un terminal y, en otros casos, necesitan `--confirm`.
Los demás comandos que cambian un grupo, incluido `group member remove`, se ejecutan
sin preguntar. Consulta [Seguridad y operaciones destructivas](https://docs.xbox.com/es/tools/xbox-cli/safety.md).

## Ciclo de vida del grupo

| Comando | Ruta de la API de PlayFab | Opciones |
| - | - | - |
| `playfab group create` | `/Group/CreateGroup` | `--group-name` obligatoria; `--entity-id` y `--entity-type` del propietario opcionales. |
| `playfab group get` | `/Group/GetGroup` | `--group-id` o `--group-name`. |
| `playfab group update` | `/Group/UpdateGroup` | `--group-id` obligatoria; `--group-name`, `--admin-role-id`, `--member-role-id` y `--expected-profile-version` opcionales. |
| `playfab group delete` | `/Group/DeleteGroup` | `--group-id` obligatoria. |

## Miembros del grupo

| Comando | Ruta de la API de PlayFab | Opciones |
| - | - | - |
| `playfab group member add` | `/Group/AddMembers` | `--group-id`, `--member-ids` y `--member-type` obligatorias; `--role-id` opcional. |
| `playfab group member remove` | `/Group/RemoveMembers` | `--group-id`, `--member-ids` y `--member-type` obligatorias; `--role-id` opcional. |
| `playfab group member change-role` | `/Group/ChangeMemberRole` | `--group-id`, `--member-ids`, `--member-type`, `--origin-role-id` y `--destination-role-id` obligatorias. |
| `playfab group member list` | `/Group/ListGroupMembers` | `--group-id` obligatoria. |
| `playfab group member is-member` | `/Group/IsMember` | `--group-id`, `--entity-id` y `--entity-type` obligatorias; `--role-id` opcional. Solo lee. |

## Roles del grupo

| Comando | Ruta de la API de PlayFab | Opciones |
| - | - | - |
| `playfab group role create` | `/Group/CreateRole` | `--group-id`, `--role-id` y `--role-name` obligatorias. |
| `playfab group role update` | `/Group/UpdateRole` | `--group-id`, `--role-id` y `--role-name` obligatorias; `--expected-profile-version` opcional. |
| `playfab group role delete` | `/Group/DeleteRole` | `--group-id` y `--role-id` obligatorias. |

## Invitaciones al grupo

| Comando | Ruta de la API de PlayFab | Opciones |
| - | - | - |
| `playfab group invite send` | `/Group/InviteToGroup` | `--group-id`, `--entity-id` y `--entity-type` obligatorias; `--role-id` y `--auto-accept` opcionales. |
| `playfab group invite accept` | `/Group/AcceptGroupInvitation` | `--group-id` obligatoria; `--entity-id` y `--entity-type` de la entidad que acepta opcionales. |
| `playfab group invite remove` | `/Group/RemoveGroupInvitation` | `--group-id`, `--entity-id` y `--entity-type` obligatorias. |
| `playfab group invite list` | `/Group/ListGroupInvitations` | `--group-id` obligatoria. |

`--auto-accept` tiene como valor predeterminado `true` para `invite send`: cuando la entidad ya ha enviado una solicitud
al grupo, PlayFab acepta la solicitud en lugar de enviar una invitación.

## Solicitudes al grupo

| Comando | Ruta de la API de PlayFab | Opciones |
| - | - | - |
| `playfab group application apply` | `/Group/ApplyToGroup` | `--group-id` obligatoria; `--entity-id`, `--entity-type` y `--auto-accept` del solicitante opcionales. |
| `playfab group application accept` | `/Group/AcceptGroupApplication` | `--group-id` obligatoria; `--entity-id` y `--entity-type` del solicitante opcionales. |
| `playfab group application remove` | `/Group/RemoveGroupApplication` | `--group-id`, `--entity-id` y `--entity-type` obligatorias. |
| `playfab group application list` | `/Group/ListGroupApplications` | `--group-id` obligatoria. |

`--auto-accept` tiene como valor predeterminado `true` para `application apply`: cuando el grupo ya ha
invitado a la entidad, PlayFab acepta la invitación en lugar de crear una solicitud.

## Bloqueos del grupo

| Comando | Ruta de la API de PlayFab | Opciones |
| - | - | - |
| `playfab group block add` | `/Group/BlockEntity` | `--group-id`, `--entity-id` y `--entity-type` obligatorias. |
| `playfab group block remove` | `/Group/UnblockEntity` | `--group-id`, `--entity-id` y `--entity-type` obligatorias. |
| `playfab group block list` | `/Group/ListGroupBlocks` | `--group-id` obligatoria. |

## Pertenencias de entidades

| Comando | Ruta de la API de PlayFab | Opciones |
| - | - | - |
| `playfab group membership list` | `/Group/ListMembership` | `--entity-id` y `--entity-type` opcionales; omite ambas para actuar sobre la entidad que realiza la llamada. |
| `playfab group membership opportunity list` | `/Group/ListMembershipOpportunities` | `--entity-id` y `--entity-type` opcionales; omite ambas para actuar sobre la entidad que realiza la llamada. |

## Salida en tabla

Estos comandos aceptan `--output table`; los demás no. Consulta
[Salida en tabla](https://docs.xbox.com/es/tools/xbox-cli/commands.md#table-output).

| Comando | Columnas |
| - | - |
| `playfab group member list` | `MEMBER ID`, `MEMBER TYPE`, `ROLE ID` |
| `playfab group invite list` | `INVITED ENTITY`, `ROLE ID`, `EXPIRES` |
| `playfab group application list` | `ENTITY`, `EXPIRES` |
| `playfab group block list` | `BLOCKED ENTITY`, `ENTITY TYPE` |
| `playfab group membership list` | `GROUP ID`, `GROUP NAME` |
| `playfab group membership opportunity list` | `TYPE`, `GROUP ID`, `ROLE ID`, `EXPIRES` |

`member list` tiene una fila por cada miembro en cada rol, por lo que un miembro con dos roles tiene dos
filas, y un rol sin miembros tiene una fila con `-` como miembro.
`membership opportunity list` muestra las invitaciones y las solicitudes en una sola tabla: `TYPE` es
`invitation` o `application`, y `ROLE ID` es `-` para una solicitud.

## Ejemplos

Leer un grupo, enumerar sus miembros, comprobar si un jugador pertenece a él y enumerar sus
invitaciones pendientes:

```bash theme={null}
xbox --playfab-title-id ABC123 playfab group get --group-id GROUP123
xbox --playfab-title-id ABC123 playfab group member list --group-id GROUP123 --data-only --output json-compact
xbox --playfab-title-id ABC123 playfab group member is-member --group-id GROUP123 --entity-id TITLEPLAYER123 --entity-type title_player_account
xbox --playfab-title-id ABC123 playfab group invite list --group-id GROUP123 --output table
```

Invitar a un jugador al grupo:

```bash theme={null}
xbox --playfab-title-id ABC123 playfab group invite send --group-id GROUP123 --entity-id TITLEPLAYER123 --entity-type title_player_account
```

Eliminar el grupo:

```bash theme={null}
xbox --playfab-title-id ABC123 playfab group delete --group-id GROUP123 --confirm
```


## Related topics

- [Obtener grupo](https://docs.xbox.com/es/services/playfab/api-references/rest/groups/groups/get-group.md)
- [Eliminar grupo](https://docs.xbox.com/es/services/playfab/api-references/rest/groups/groups/delete-group.md)
- [Crear grupo](https://docs.xbox.com/es/services/playfab/api-references/rest/groups/groups/create-group.md)
- [Actualizar grupo](https://docs.xbox.com/es/services/playfab/api-references/rest/groups/groups/update-group.md)
- [Grupos de productos](https://docs.xbox.com/es/publishing/game-publishing/concepts/product-groups.md)
