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

# Services C API overview - PFGroupsTypes.h

> Services C API overview - PFGroupsTypes.h

## Structures

| Structure | Description |
| - | - |
| [PFGroupsAcceptGroupApplicationRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsacceptgroupapplicationrequest.md) | PFGroupsAcceptGroupApplicationRequest 데이터 모델입니다. 초대된 엔터티가 그룹에 의해 차단되지 않은 경우 그룹 가입에 대한 미결 초대를 수락합니다. 성공한 경우 반환되는 값은 없습니다. |
| [PFGroupsAcceptGroupInvitationRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsacceptgroupinvitationrequest.md) | PFGroupsAcceptGroupInvitationRequest 데이터 모델입니다. 초대된 엔터티가 그룹에 의해 차단되지 않은 경우 그룹 가입에 대한 미결 초대를 수락합니다. 초대된 엔터티 또는 그 체인의 부모(예: 타이틀)만이 초대된 엔터티를 대신하여 초대를 수락할 수 있습니다. 성공한 경우 반환되는 값은 없습니다. |
| [PFGroupsAddMembersRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsaddmembersrequest.md) | PFGroupsAddMembersRequest 데이터 모델입니다. 그룹 또는 역할에 멤버를 추가합니다. 그룹의 기존 멤버는 그룹 내 역할에 추가되지만, 사용자가 아직 그룹의 멤버가 아닌 경우, 타이틀 소유자만이 이들을 그룹에 추가할 수 있으며, 그 외에는 그룹 신청 또는 초대 시스템을 사용하여 새 멤버를 그룹에 추가해야 합니다. 성공하면 아무 것도 반환하지 않습니다. |
| [PFGroupsApplyToGroupRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsapplytogrouprequest.md) | PFGroupsApplyToGroupRequest 데이터 모델입니다. 그룹 가입 신청을 만듭니다. 그룹 신청이 이미 존재하는 상태에서 이 함수를 호출하면 오류 대신 동일한 신청이 반환되며, 신청 만료까지의 시간은 갱신되지 않습니다. 기본적으로 엔터티에 그룹 가입 초대가 남아 있는 경우, 나중에 정리해야 할 중복된 가입 신청을 만드는 대신 그룹 가입 초대를 수락하고 이를 나타내는 오류를 반환합니다. 신청에 대한 정보 또는 초대가 대신 수락되었음을 나타내는 오류를 반환합니다. |
| [PFGroupsApplyToGroupResponse](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsapplytogroupresponse.md) | PFGroupsApplyToGroupResponse 데이터 모델입니다. 그룹 가입 신청을 설명합니다. |
| [PFGroupsBlockEntityRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsblockentityrequest.md) | PFGroupsBlockEntityRequest 데이터 모델입니다. 그룹 가입에서 엔터티 목록을 차단합니다. 차단된 엔터티는 새 가입 신청을 만들거나, 가입에 초대되거나, 초대를 수락하거나, 신청이 수락되도록 할 수 없습니다. 차단으로 인한 실패는 해당 그룹에 대한 기존 신청이나 초대를 정리하지 않습니다. 성공한 경우 반환되는 데이터는 없습니다. |
| [PFGroupsChangeMemberRoleRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupschangememberrolerequest.md) | PFGroupsChangeMemberRoleRequest 데이터 모델입니다. 엔터티 목록의 역할 멤버십을 한 역할에서 다른 역할로 단일 작업으로 변경합니다. 대상 역할이 이미 존재해야 합니다. 이는 엔터티를 대상 역할에 추가하고 원본 역할에서 제거하는 것과 동일합니다. 성공하면 아무 것도 반환하지 않습니다. |
| [PFGroupsCreateGroupRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupscreategrouprequest.md) | PFGroupsCreateGroupRequest 데이터 모델입니다. 타이틀의 그룹 템플릿을 기반으로 관리 역할과 멤버 역할을 포함한 새 그룹을 만듭니다. 생성된 그룹에 대한 정보를 반환합니다. |
| [PFGroupsCreateGroupResponse](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupscreategroupresponse.md) | PFGroupsCreateGroupResponse 데이터 모델입니다. |
| [PFGroupsCreateGroupRoleRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupscreategrouprolerequest.md) | PFGroupsCreateGroupRoleRequest 데이터 모델입니다. 기존 그룹 내에 멤버가 없는 새 역할을 만듭니다. 역할 ID와 역할 이름은 모두 그룹 내에서 고유해야 하지만, 이름은 ID와 동일할 수 있습니다. 역할 ID는 생성 시 설정되며 변경할 수 없습니다. 생성된 역할에 대한 정보를 반환합니다. |
| [PFGroupsCreateGroupRoleResponse](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupscreategrouproleresponse.md) | PFGroupsCreateGroupRoleResponse 데이터 모델입니다. |
| [PFGroupsDeleteGroupRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsdeletegrouprequest.md) | PFGroupsDeleteGroupRequest 데이터 모델입니다. 그룹과 그룹에 연결된 모든 역할, 초대, 가입 요청 및 차단을 삭제합니다. 이 작업을 실행하려면 그룹 자체에 대한 삭제 권한만 필요합니다. 그룹과 데이터는 제거된 후에는 복구할 수 없지만, 그룹에 대한 신고는 그대로 유지됩니다. 성공한 경우 반환되는 데이터는 없습니다. |
| [PFGroupsDeleteRoleRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsdeleterolerequest.md) | PFGroupsDeleteRoleRequest 데이터 모델입니다. 역할에 대한 정보를 반환합니다. |
| [PFGroupsEntityMemberRole](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsentitymemberrole.md) | PFGroupsEntityMemberRole 데이터 모델입니다. |
| [PFGroupsEntityWithLineage](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsentitywithlineage.md) | PFGroupsEntityWithLineage 데이터 모델입니다. 엔터티 키와 엔터티의 계보를 구성하는 엔터티를 포함하는 엔터티 래퍼 클래스입니다. |
| [PFGroupsGetGroupRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsgetgrouprequest.md) | PFGroupsGetGroupRequest 데이터 모델입니다. 그룹의 ID, 이름, 역할 목록 및 기타 멤버십과 관련이 없는 정보를 반환합니다. |
| [PFGroupsGetGroupResponse](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsgetgroupresponse.md) | PFGroupsGetGroupResponse 데이터 모델입니다. |
| [PFGroupsGroupApplication](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsgroupapplication.md) | PFGroupsGroupApplication 데이터 모델입니다. 그룹 가입 신청을 설명합니다. |
| [PFGroupsGroupBlock](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsgroupblock.md) | PFGroupsGroupBlock 데이터 모델입니다. 그룹 가입에서 차단된 엔터티를 설명합니다. |
| [PFGroupsGroupInvitation](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsgroupinvitation.md) | PFGroupsGroupInvitation 데이터 모델입니다. 그룹에 대한 초대를 설명합니다. |
| [PFGroupsGroupRole](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsgrouprole.md) | PFGroupsGroupRole 데이터 모델입니다. 그룹 역할을 설명합니다. |
| [PFGroupsGroupWithRoles](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsgroupwithroles.md) | PFGroupsGroupWithRoles 데이터 모델입니다. 그룹과 그 그룹에 포함된 역할을 설명합니다. |
| [PFGroupsInviteToGroupRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsinvitetogrouprequest.md) | PFGroupsInviteToGroupRequest 데이터 모델입니다. 그룹에 의해 차단되지 않은 경우 플레이어를 그룹에 초대합니다. 선택 사항으로 역할을 제공하면 플레이어가 초대를 수락할 때 자동으로 해당 역할에 할당할 수 있습니다. 기본적으로 엔터티에 그룹에 대한 신청이 남아 있는 경우, 나중에 정리해야 하는 중복된 가입 초대를 생성하는 대신 기존 신청을 수락하고 그에 따른 오류를 반환합니다. 새 초대에 대한 정보 또는 기존 가입 신청이 수락되었음을 나타내는 오류를 반환합니다. |
| [PFGroupsInviteToGroupResponse](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsinvitetogroupresponse.md) | PFGroupsInviteToGroupResponse 데이터 모델입니다. 그룹에 대한 초대를 설명합니다. |
| [PFGroupsIsMemberRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsismemberrequest.md) | PFGroupsIsMemberRequest 데이터 모델입니다. 엔터티가 그룹의 멤버이거나 그룹 내 역할의 멤버인지 확인합니다. 엔터티가 그룹의 멤버인지 여부를 나타내는 결과가 반환되거나, 호출자가 그룹의 멤버 목록을 읽을 권한이 없는 경우 권한 오류가 반환됩니다. |
| [PFGroupsIsMemberResponse](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsismemberresponse.md) | PFGroupsIsMemberResponse 데이터 모델입니다. |
| [PFGroupsListGroupApplicationsRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupslistgroupapplicationsrequest.md) | PFGroupsListGroupApplicationsRequest 데이터 모델입니다. 그룹 가입에 대한 모든 미결 요청을 나열합니다. 모든 가입 요청 목록과 요청 만료 시기를 반환합니다. 특정 엔터티의 그룹 신청을 가져오려면 ListMembershipOpportunities를 사용합니다. |
| [PFGroupsListGroupApplicationsResponse](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupslistgroupapplicationsresponse.md) | PFGroupsListGroupApplicationsResponse 데이터 모델입니다. |
| [PFGroupsListGroupBlocksRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupslistgroupblocksrequest.md) | PFGroupsListGroupBlocksRequest 데이터 모델입니다. 그룹 가입에서 차단된 모든 엔터티를 나열합니다. 차단된 엔터티 목록이 반환됩니다. |
| [PFGroupsListGroupBlocksResponse](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupslistgroupblocksresponse.md) | PFGroupsListGroupBlocksResponse 데이터 모델입니다. |
| [PFGroupsListGroupInvitationsRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupslistgroupinvitationsrequest.md) | PFGroupsListGroupInvitationsRequest 데이터 모델입니다. 그룹에 대한 모든 미결 초대를 나열합니다. 초대된 엔터티 목록과 초대 만료 시기를 반환합니다. 특정 엔터티에 대한 그룹 초대를 가져오려면 ListMembershipOpportunities를 사용합니다. |
| [PFGroupsListGroupInvitationsResponse](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupslistgroupinvitationsresponse.md) | PFGroupsListGroupInvitationsResponse 데이터 모델입니다. |
| [PFGroupsListGroupMembersRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupslistgroupmembersrequest.md) | PFGroupsListGroupMembersRequest 데이터 모델입니다. 그룹 내의 멤버와 이들이 속한 역할 목록을 가져옵니다. 호출자에게 역할을 볼 권한이 없고 멤버가 다른 역할에 속해 있지 않은 경우, 해당 멤버는 표시되지 않습니다. 그룹의 멤버인 엔터티 목록을 반환합니다. |
| [PFGroupsListGroupMembersResponse](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupslistgroupmembersresponse.md) | PFGroupsListGroupMembersResponse 데이터 모델입니다. |
| [PFGroupsListMembershipOpportunitiesRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupslistmembershipopportunitiesrequest.md) | PFGroupsListMembershipOpportunitiesRequest 데이터 모델입니다. 엔터티에 대한 모든 미결 그룹 신청 및 초대를 나열합니다. 누구나 어떤 엔터티에 대해서도 이 API를 호출할 수 있지만, 데이터는 해당 엔터티 또는 그 엔터티의 부모에 대해서만 반환됩니다. 플레이어가 그룹에 가입을 시도하고 있는지 확인하기 위해 그룹의 초대 또는 신청을 나열하려면 ListGroupInvitations 및 ListGroupApplications를 사용합니다. |
| [PFGroupsListMembershipOpportunitiesResponse](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupslistmembershipopportunitiesresponse.md) | PFGroupsListMembershipOpportunitiesResponse 데이터 모델입니다. |
| [PFGroupsListMembershipRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupslistmembershiprequest.md) | PFGroupsListMembershipRequest 데이터 모델입니다. 엔터티가 속한 그룹과 역할을 나열하며, 그룹과 역할의 메타데이터 및 멤버십이 호출자에게 표시되어야 하는지 확인합니다. 엔터티가 호출자에게 표시되는 역할에 속해 있지 않으면, 호출자가 엔터티가 해당 그룹의 멤버임을 볼 권한이 있더라도 그룹은 결과에 반환되지 않습니다. |
| [PFGroupsListMembershipResponse](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupslistmembershipresponse.md) | PFGroupsListMembershipResponse 데이터 모델입니다. |
| [PFGroupsRemoveGroupApplicationRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsremovegroupapplicationrequest.md) | PFGroupsRemoveGroupApplicationRequest 데이터 모델입니다. 그룹 가입에 대한 기존 신청을 제거합니다. 이 API는 신청 거부와 신청 철회 양쪽 모두에 사용됩니다. 신청 엔터티 또는 그 체인의 부모(예: 타이틀)는 신청을 철회할 수 있으며, 그룹에 적절한 액세스 권한이 있는 호출자는 누구나 신청을 거부할 수 있습니다. 성공한 경우 반환되는 데이터는 없습니다. |
| [PFGroupsRemoveGroupInvitationRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsremovegroupinvitationrequest.md) | PFGroupsRemoveGroupInvitationRequest 데이터 모델입니다. 그룹 가입에 대한 기존 초대를 제거합니다. 이 API는 초대 거부와 초대 철회 양쪽 모두에 사용됩니다. 초대된 엔터티 또는 그 체인의 부모(예: 타이틀)는 이 메서드를 호출하여 초대를 거부할 수 있으며, 그룹에 적절한 액세스 권한이 있는 호출자는 누구나 초대를 철회할 수 있습니다. 성공한 경우 반환되는 데이터는 없습니다. |
| [PFGroupsRemoveMembersRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsremovemembersrequest.md) | PFGroupsRemoveMembersRequest 데이터 모델입니다. 그룹에서 멤버를 제거합니다. 멤버는 권한과 관계없이 언제든지 자신을 그룹에서 제거할 수 있습니다. 성공하면 아무 것도 반환하지 않습니다. |
| [PFGroupsUnblockEntityRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsunblockentityrequest.md) | PFGroupsUnblockEntityRequest 데이터 모델입니다. 그룹 가입 차단에서 엔터티 목록을 해제합니다. 성공한 경우 반환되는 데이터는 없습니다. |
| [PFGroupsUpdateGroupRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsupdategrouprequest.md) | PFGroupsUpdateGroupRequest 데이터 모델입니다. 이름 또는 기본 멤버 역할과 같은 그룹에 대한 데이터를 업데이트합니다. 업데이트가 성공했는지 여부에 대한 정보를 반환합니다. 타이틀 소유자만 그룹의 관리 역할을 수정할 수 있습니다. |
| [PFGroupsUpdateGroupResponse](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsupdategroupresponse.md) | PFGroupsUpdateGroupResponse 데이터 모델입니다. |
| [PFGroupsUpdateGroupRoleRequest](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsupdategrouprolerequest.md) | PFGroupsUpdateGroupRoleRequest 데이터 모델입니다. 역할 이름을 업데이트합니다. 업데이트가 성공했는지 여부에 대한 정보를 반환합니다. |
| [PFGroupsUpdateGroupRoleResponse](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsupdategrouproleresponse.md) | PFGroupsUpdateGroupRoleResponse 데이터 모델입니다. |


## Related topics

- [PFGroupsGroupApplication](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsgroupapplication.md)
- [PFGroupsGroupBlock](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsgroupblock.md)
- [PFGroupsGroupInvitation](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsgroupinvitation.md)
- [PFGroupsGroupRole](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsgrouprole.md)
- [PFGroupsGroupWithRoles](https://docs.xbox.com/ko/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsgroupwithroles.md)