---
metadata:
  - name: generator
    content: Diplodoc Platform v5.64.0
alternate:
  - https://boost.yandex.com/doc/en/analytics/content/mobile-api/push/put-group-id.md
  - https://boost.yandex.com/doc/ru/analytics/content/mobile-api/push/put-group-id.md
  - https://boost.yandex.com/doc/zh/analytics/content/mobile-api/push/put-group-id.md
  - href: https://boost.yandex.com/doc/zh/analytics/content/mobile-api/push/put-group-id.md
    type: text/markdown
    title: Markdown version
  - href: https://boost.yandex.com/doc/zh/llms.txt?revision=r21772739
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://boost.yandex.com/doc/zh/llms.txt?revision=r21772739

# 更新组

修改现有[组](*group)的名称。

## 请求格式 {#request-format}

```
PUT https://push.api.appmetrica.yandex.net/push/v1/management/group/{groupId}
```

#|
|| `groupId` | 组 ID。 ||
|#

## Request body

```json translate=no
{
  "group": {
    "name": "string",
    "send_rate": int
  }
}
```
#|
|| `group` | 有关组的信息。 ||
|| `group.name`* | 为组设置新名称。 ||
|| `组发送速率` | 推送消息的发送速度限制（每秒消息数）。

默认值为 5000（最大）。

最小值为 100。


{% note info %}

降低速度可以减少你的处理服务负载。

{% endnote %}

||
|#

## 响应格式 {#response-format}

```json translate=no
{
  "group": {
    "id": int,
    "app_id": int,
    "name": "string",
    "send_rate": int
  }
}
```

#|
|| `group` | 有关组的信息。 ||
|| `group.id` | 组 ID。 ||
|| `group.app_id` | 应用 ID。 ||
|| `group.name` | 组的唯一名称。 ||
|| `组发送速率` | 推送消息的发送速度限制（每秒消息数）。

默认值为 5000（最大）。

最小值为 100。


{% note info %}

降低速度可以减少您的处理服务负载。

{% endnote %}

||
|#

## 示例请求 {#example}

{% list tabs %}

- cURL

   ```bash translate=no
   curl -X POST \
     'https://push.api.appmetrica.yandex.net/push/v1/management/group/XXXXXX' \
     -H 'Content-Type: application/json' \
     -H 'Authorization: OAuth <your_token>'
     -d '{"group":{"name":"new_group_name"}}'
   ```

   where `<your_token>` 是一个 OAuth 令牌，可以通过 [说明](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/intro/authorization.md#get-oauth-token) 获取。

- HTTP

   ```http translate=no
   GET /push/v1/management/group/XXXXXX HTTP/1.1
   Host: push.api.appmetrica.yandex.net
   Content-Type: application/json
   Authorization: OAuth <your_token>
   
   {
     "group": {
       "name": "new_group_name"
     }
   }
   ```

   其中 `<your_token>` 是一个 OAuth 令牌，可以通过 [说明](https://boost.yandex.com/doc/zh/analytics/content/mobile-api/intro/authorization.md#get-oauth-token) 获取。

{% endlist %}

<!-- source: zh/analytics/content/_includes/feedback-button-2.md -->
如果您没有找到所需答案，可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能，请附上截图。

<a href="../troubleshooting/feedback-new">
  <span class="button">联系支持</span>
</a>

<a href="../troubleshooting/feedback-docs">
  <span class="button">建议改进文档</span>
</a>
<!-- endsource: zh/analytics/content/_includes/feedback-button-2.md -->

[*group]: 一个组是发送推送消息的容器。 它允许在[推送活动报告](https://boost.yandex.com/doc/zh/analytics/content/mobile-reports/push-campaign.md)中对消息发送进行分组。 该组可以包含任意数量的发送。 推送活动报告在第一级显示这些组，以及通过[网页界面](https://boost.yandex.com/doc/zh/analytics/content/push/marketing.md)启动的推送活动。