*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

GroupRole

grupiçindeki üyelere özel ayrıcalıklar vermek için yapılandırılabilir bir özellik.

Nitelikler

pathstring

Grup rolünün kaynak yolu.

Biçim: groups/{group_id}/roles/{group_role_id}.

createTimestring

Yalnızca Çıkış

Grup rolünün son kez güncellendiği tarih ve saat.

grupsahipler tarafından yalnızca görülebilir. Bu dizi Timestamp olarak biçimlendirilmiş.

updateTimestring

Yalnızca Çıkış

Grup rolünün son kez güncellendiği tarih ve saat.

grupsahipler tarafından yalnızca görülebilir. Bu dizi Timestamp olarak biçimlendirilmiş.

idstring

Yalnızca Çıkış

Bir rolü tanımlayan benzersiz bir kimlik.

Grupta yalnızca benzersiz olan bir rolün rütbesinden ayrı, ki bu sadece grupiçinde benzersizdir.

displayNamestring

Rolün adı.

100 karakterin maksimum sınırı vardır. Sınırın üzerindeki isimler reddedilir.

descriptionstring

Rolün açıklaması.

1000 karakterin maksimum sınırı vardır. Sınırın üzerindeki dize reddedilir. Sadece grupsahipleri tarafından görülebilir.

ranknumber

Rolün rütbesi.

Minimum değer 0'dır. Maksimum değer 255'dir.

memberCountnumber

Yalnızca Çıkış

Bir roldaki toplam üye sayısı.

Bu alan misafir roller için iade edilmez.

permissionsobject

Bu rol için verilen izinler.

Bu değer, yetkilendirilmiş kullanıcının veya API anahtar yaratıcısının okuma alanı ve rolüne dayanarak doldurulur.Kullanıcı veya yaratıcı ana grubun sahibi ise, grubdaki tüm rol izinlerini görebilirler.Kullanıcı veya yaratıcı ebeveyn grubun üyesi ise, rol izinlerini grupta görebilirler.Herkes misafir izinlerini görebilir.Birisinin izinleri göremediği durumda, bu alan iade edilmez.

Taban URL

https://apis.roblox.com

GroupRole Kaynağı

{
  "path": "groups/123/roles/123",
  "createTime": "2023-07-05T12:34:56Z",
  "updateTime": "2023-07-05T12:34:56Z",
  "id": "200",
  "displayName": "Member",
  "description": "This is a description for the role",
  "rank": 1,
  "memberCount": 10223136,
  "permissions": {
    "viewWallPosts": true,
    "createWallPosts": true,
    "deleteWallPosts": true,
    "viewGroupShout": true,
    "createGroupShout": true,
    "changeRank": true,
    "acceptRequests": true,
    "exileMembers": true,
    "manageRelationships": true,
    "viewAuditLog": true,
    "spendGroupFunds": true,
    "advertiseGroup": true,
    "createAvatarItems": true,
    "manageAvatarItems": true,
    "manageGroupUniverses": true,
    "viewUniverseAnalytics": true,
    "createApiKeys": true,
    "manageApiKeys": true,
    "banMembers": true,
    "viewForums": true,
    "manageCategories": true,
    "createPosts": true,
    "lockPosts": true,
    "pinPosts": true,
    "removePosts": true,
    "createComments": true,
    "removeComments": true
  }
}

GroupRole

List Group Roles
Beta

GET /cloud/v2/groups/{group_id}/roles

Bir gruprol listesini oluştur.

Rol için izin alanı, isteyenin erişimi ve alanlarına göre görülebilir.

Misafir rol için izinler daima görünür - bir alan gerekmiyor.

İstekçi grubun bir üyesi ve group:read alanına sahipse, rolündeki izinler görülebilir.

İstek sahibi grubun sahibi ise ve group:read alanına sahipse, tüm rollerde izinler görülebilir.

TalepYol Parametreleri

group_idstring

Gerekli

Grup kimliği.

Sorgu Parametreleri

maxPageSizenumber

Geri döndürülecek grup rolü maksimum sayısı.Hizmet bu değerden daha azını iade edebilir.Belirtilmediğinde, en fazla 10 grup rolü döndürülür.Maksimum değer 20 ve daha yüksek değerler 20 olarak ayarlanır.

pageTokenstring

Bir önceki çağrıdan alınan bir sayfa jetonu, sonraki bir sayfa almak için.

Sayfa numaralandırırken, sonraki çağrıya verilen tüm diğer parametler, sayfa jetonu sağlayan çağrıya eşleşmelidir.

Yanıt

Ebeveyn koleksiyonundaki GrupRol listesi.

groupRolesarray<GroupRole>

Belirtilen Gruptan GrupRol'lar.

nextPageTokenstring

Bir sonraki sayfayı almak için bir pageToken çözümleyici olarak gönderebileceğiniz bir jeton. Bu alan atlanırsa, sonraki sayfalar yoktur.

GET /cloud/v2/groups/{group_id}/roles

curl -L -X GET 'https://apis.roblox.com/cloud/v2/groups/{group_id}/roles?maxPageSize=10&pageToken={string}' \
  -H 'x-api-key: {your-api-key}'

Yanıt

{
  "groupRoles": [
    {
      "path": "groups/123/roles/123",
      "createTime": "2023-07-05T12:34:56Z",
      "updateTime": "2023-07-05T12:34:56Z",
      "id": "200",
      "displayName": "Member",
      "description": "This is a description for the role",
      "rank": 1,
      "memberCount": 10223136,
      "permissions": {
        "viewWallPosts": true,
        "createWallPosts": true,
        "deleteWallPosts": true,
        "viewGroupShout": true,
        "createGroupShout": true,
        "changeRank": true,
        "acceptRequests": true,
        "exileMembers": true,
        "manageRelationships": true,
        "viewAuditLog": true,
        "spendGroupFunds": true,
        "advertiseGroup": true,
        "createAvatarItems": true,
        "manageAvatarItems": true,
        "manageGroupUniverses": true,
        "viewUniverseAnalytics": true,
        "createApiKeys": true,
        "manageApiKeys": true,
        "banMembers": true,
        "viewForums": true,
        "manageCategories": true,
        "createPosts": true,
        "lockPosts": true,
        "pinPosts": true,
        "removePosts": true,
        "createComments": true,
        "removeComments": true
      }
    }
  ],
  "nextPageToken": "string"
}

GroupRole

Get Group Role
Beta

GET /cloud/v2/groups/{group_id}/roles/{role_id}

Grup rolünü alın

TalepYol Parametreleri

group_idstring

Gerekli

Grup kimliği.

role_idstring

Gerekli

Rol ID'sı.

YanıtGroupRole

GET /cloud/v2/groups/{group_id}/roles/{role_id}

curl -L -X GET 'https://apis.roblox.com/cloud/v2/groups/{group_id}/roles/{role_id}' \
  -H 'x-api-key: {your-api-key}'

Yanıt

{
  "path": "groups/123/roles/123",
  "createTime": "2023-07-05T12:34:56Z",
  "updateTime": "2023-07-05T12:34:56Z",
  "id": "200",
  "displayName": "Member",
  "description": "This is a description for the role",
  "rank": 1,
  "memberCount": 10223136,
  "permissions": {
    "viewWallPosts": true,
    "createWallPosts": true,
    "deleteWallPosts": true,
    "viewGroupShout": true,
    "createGroupShout": true,
    "changeRank": true,
    "acceptRequests": true,
    "exileMembers": true,
    "manageRelationships": true,
    "viewAuditLog": true,
    "spendGroupFunds": true,
    "advertiseGroup": true,
    "createAvatarItems": true,
    "manageAvatarItems": true,
    "manageGroupUniverses": true,
    "viewUniverseAnalytics": true,
    "createApiKeys": true,
    "manageApiKeys": true,
    "banMembers": true,
    "viewForums": true,
    "manageCategories": true,
    "createPosts": true,
    "lockPosts": true,
    "pinPosts": true,
    "removePosts": true,
    "createComments": true,
    "removeComments": true
  }
}

GroupRole

Nitelikler

GroupRole

List Group RolesBeta

GroupRole

Get Group RoleBeta

List Group Roles
Beta

Get Group Role
Beta