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