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

# PFGroupsCreateGroupRoleRequest

> PFGroupsCreateGroupRoleRequest データ モデル。既存のグループ内にメンバーがいない新しいロールを作成します。ロール ID とロール名の両方が一意である必要があります。

PFGroupsCreateGroupRoleRequest データ モデル。既存のグループ内にメンバーがいない新しいロールを作成します。ロール ID とロール名の両方がグループ内で一意である必要がありますが、名前は ID と同じにすることもできます。ロール ID は作成時に設定され、変更できません。作成されたロールに関する情報を返します。

## 構文

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

### メンバー

**`customTags`**   [PFStringDictionaryEntry](/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*may be nullptr*

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

**`customTagsCount`**   uint32\_t

customTags の数

**`group`**   [PFEntityKey](/services/playfab/api-references/c/pftypes/structs/pfentitykey-c) const\*

グループの識別子。

**`roleId`**   const char\*<br />*is null-terminated*

ロールの ID。これはグループ内で一意である必要があり、変更できません。ロール ID は 1 ～ 64 文字の長さである必要があり、a-Z、A-Z、0-9、'(' 、')' 、'\_' 、'-' 、'.' に制限されます。

**`roleName`**   const char\*<br />*is null-terminated*

ロールの名前。これはグループ内で一意である必要があり、後から変更できます。ロール名は 1 ～ 100 文字の長さである必要があります。

## 要件

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

## 関連項目

[PFGroupsTypes のメンバー](/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members)


## Related topics

- [PFGroupsCreateRoleAsync](/ja-jp/services/playfab/api-references/c/pfgroups/functions/pfgroupscreateroleasync.md)
- [Services C API overview - PFGroupsTypes.h](/ja-jp/services/playfab/api-references/c/pfgroupstypes/pfgroupstypes_members.md)
- [PFGroupsCreateGroupRoleResponse](/ja-jp/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupscreategrouproleresponse.md)
- [PFGroupsUpdateGroupRoleRequest](/ja-jp/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsupdategrouprolerequest.md)
- [PFGroupsDeleteRoleRequest](/ja-jp/services/playfab/api-references/c/pfgroupstypes/structs/pfgroupsdeleterolerequest.md)