Group Type ID | RESTful API Support |
Private | Yes. Same as work groups (Work) in the new version. |
Public | Yes |
ChatRoom | Yes. Same as meeting groups (Meeting) in the new version. |
AVChatRoom | Yes |
Community | Yes |
https://xxxxxx/v4/group_open_http_svc/modify_group_base_info?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json
Parameter | Description |
xxxxxx | Domain name corresponding to the country/region where your SDKAppID is located. China: console.tim.qq.com Singapore: adminapisgp.im.qcloud.com Seoul: adminapikr.im.qcloud.com Frankfurt: adminapiger.im.qcloud.com Silicon Valley: adminapiusa.im.qcloud.com Jakarta: adminapiidn.im.qcloud.com |
v4/group_open_http_svc/modify_group_base_info | Request API. |
sdkappid | SDKAppID assigned by the Chat console when an app is created |
identifier | |
usersig | |
random | A random 32-bit unsigned integer ranging from 0 to 4294967295. |
contenttype | Request format, which should always be json . |
{"GroupId": "@TGS#1NVTZEAE4", // Group whose basic profile you want to modify (required)"Name": "NewName", // Group name (optional)"Introduction": "NewIntroduction", // Group introduction (optional)"Notification": "NewNotification", // Group notice (optional)"FaceUrl": "http://this.is.new.face.url", // Group profile photo (optional)"MaxMemberNum": 500, // Maximum number of group members (optional)"ApplyJoinOption": "NeedPermission", // Method for applying to join the group (optional)"MuteAllMember": "On" // Mutes all members (optional). "On": Enable, "Off": Disable}
{"GroupId": "@TGS#1NVTZEAE4", // Group whose basic profile you want to modify (required)"AppDefinedData": [ // Custom field (optional){"Key": "GroupTestData1", // Custom field key to be modified"Value": "NewData" // New value of the custom field}]}
{"GroupId": "@TGS#1NVTZEAE4", // Group whose basic profile you want to modify (required)"AppDefinedData": [ // Custom field (optional){"Key": "GroupTestData2","Value": "" // If this parameter is empty, the custom field is to be deleted.}]}
{"GroupId": "@TGS#2J4SZEAEL", // Group whose basic profile you want to modify (required)"Name": "NewName", // Group name (optional)"Introduction": "NewIntroduction", // Group introduction (optional)"Notification": "NewNotification", // Group notice (optional)"FaceUrl": "http://this.is.new.face.url", // Group profile photo (optional)"MaxMemberNum": 500, // Maximum number of group members (optional)"ApplyJoinOption": "NeedPermission", // Method for applying to join the group (optional)"MuteAllMember": "On", // Mutes all members, which is optional. `On`: Enable. `Off`: Disable"AppDefinedData": [ // Custom field (optional){"Key": "GroupTestData1", // Custom field key to be modified"Value": "NewData" // New value of the custom field},{"Key": "GroupTestData2","Value": "" // If this parameter is empty, the custom field is to be deleted.}]}
Field | Type | Required | Description |
GroupId | String | Required | ID of the group whose basic information you want to modify. |
Name | String | Optional | The maximum length is 30 bytes. This field is UTF-8-encoded, and one Chinese character occupies three bytes. |
Introduction | String | Optional | The maximum length is 240 bytes. This field is UTF-8-encoded, and one Chinese character occupies three bytes. |
Notification | String | Optional | The maximum length is 300 bytes. This field is UTF-8-encoded, and one Chinese character occupies three bytes. |
FaceUrl | String | Optional | URL of the group profile photo, whose maximum length is 100 bytes. |
MaxMemberNum | Integer | No | Maximum number of group members For work groups (Work), public groups (Public), meeting groups (Meeting), and communities, see the upper limit on the number of group members in Group System. For audio-video groups (AVChatRoom), this field is invalid and doesn't need to be specified. |
ApplyJoinOption | String | Optional | Method for handling requests to join the group. Valid values: FreeAccess , NeedPermission , and DisableApply . Community groups currently do not support this field. |
AppDefinedData | Array | Optional | By default, this field is not available. To learn how to enable group-level custom fields, see Custom Fields. |
MuteAllMember | String | Optional | Mutes all members in a group and allows only the group admin, group owner, and system admin to speak. |
InviteJoinOption | String | Optional | Method for handling invitations to join the group. Valid values: FreeAccess (directly inviting users to the group without approval and other operations), NeedPermission (requiring approval from the group admin or owner), and DisableInvite (not supporting SDK invitations to the group). This option is not supported by the AVChatRoom group type. |
From_Account | String | Optional | Operator source account, optional. If this field is not filled in, the operator who modifies the group information is the App admin account used when calling this interface. In addition, the App can also "forge" the operator who modifies the group information through this field to implement some special functional requirements. If you specify this field, you must ensure that the account in the field exists. |
EnablePermission | Integer | Optional | Only communities that support topics can set this field. Whether to enable the permission group as the basis for permission judgement: 0: Disable 1: Enable |
DefaultPermission | Integer | Optional | Only groups that enable the permission group as the basis for permission judgement can set this field. The default permissions of a group member in the group. |
{"ActionStatus": "OK","ErrorInfo": "","ErrorCode":0}
Field | Type | Description |
ActionStatus | String | Request result. OK : successful; FAIL : failed |
ErrorCode | Integer | Error code. 0 : Successful; other values: Failed |
ErrorInfo | String | Error information |
ErrorCode
and ErrorInfo
respectively.
For public error codes (60000 to 79999), see Error Codes.
The following table describes the error codes specific to this API:Error Code | Description |
10002 | Internal server error. Try again. |
10003 | Invalid command word. |
10004 | Invalid parameter. Check the error description and troubleshoot the issue. |
10026 | |
10007 | Insufficient operation permissions. Check whether the operator is the app admin or whether the operator has the permission to modify the fields in the request. |
10010 | The group does not exist or has been deleted. |
10015 | Invalid group ID. Use the correct group ID. |
Was this page helpful?