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

# PFGroupsAddMembersRequest

> PFGroupsAddMembersRequest データ モデル。グループまたはロールにメンバーを追加します。グループの既存メンバーはグループ内のロールに追加できますが、ユーザーが。

PFGroupsAddMembersRequest データ モデル。グループまたはロールにメンバーを追加します。グループの既存メンバーはグループ内のロールに追加できますが、ユーザーがまだグループのメンバーでない場合は、タイトル クレーム所有者のみがグループに追加でき、それ以外の場合はグループ申請または招待システムを使用して新しいメンバーをグループに追加する必要があります。成功した場合、何も返されません。

## 構文

```cpp theme={null}
typedef struct PFGroupsAddMembersRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    PFEntityKey const* group;  
    PFEntityKey const* members;  
    uint32_t membersCount;  
    const char* roleId;  
} PFGroupsAddMembersRequest;  
```

### メンバー

**`customTags`**   [PFStringDictionaryEntry](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry.md) const\*\
*may be nullptr*

(省略可能) リクエストに関連付けられている省略可能なカスタム タグ (ビルド番号、外部トレース識別子など)。

**`customTagsCount`**   uint32\_t

customTags の数

**`group`**   [PFEntityKey](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pftypes/structs/pfentitykey-c.md) const\*

グループの識別子。

**`members`**   [PFEntityKey](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pftypes/structs/pfentitykey-c.md) const\*

グループに追加するエンティティの一覧。グループに追加できるのは、種類が title\_player\_account および character のエンティティのみです。

**`membersCount`**   uint32\_t

members の数

**`roleId`**   const char\*\
*is null-terminated*

(省略可能) 省略可能: エンティティを追加する既存のロールの ID。これが指定されていない場合、そのグループの既定のメンバー ロールが使用されます。ロール ID は 1 ～ 64 文字の長さである必要があります。

## 要件

**ヘッダー:** PFGroupsTypes.h

## 関連項目

[PFGroupsTypes のメンバー](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)


## Related topics

- [PFGroupsAddMembersAsync](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfgroups/functions/pfgroupsaddmembersasync.md)
- [Services C API overview - PFGroupsTypes.h](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)
- [Add Shared Group Members](https://docs.xbox.com/api-reference/shared-group-data/add-shared-group-members.md)
- [PFGroupsIsMemberRequest](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsismemberrequest.md)
- [PFGroupsListGroupMembersRequest](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupslistgroupmembersrequest.md)