---
metadata:
  - name: generator
    content: Diplodoc Platform v5.63.4
alternate:
  - https://appmetrica.yandex.com/docs/en/mobile-api/push/get-groups.md
  - https://appmetrica.yandex.com/docs/ru/mobile-api/push/get-groups.md
  - https://appmetrica.yandex.com/docs/zh/mobile-api/push/get-groups.md
  - href: https://appmetrica.yandex.com/docs/zh/mobile-api/push/get-groups.md
    type: text/markdown
    title: Markdown version
  - href: https://appmetrica.yandex.com/docs/zh/llms.txt?revision=r21698989
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.com/docs/zh/llms.txt?revision=r21698989

# 组合列表

返回指定应用的所有组。

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

```
获取 https://push.api.appmetrica.yandex.net/push/v1/management/groups
  ? app_id=<string>
```

#|
||`app_id`* | 应用 ID。 ||
|#

## 响应格式（JSON）

```json translate=no
{
  "groups" : [
    {
      "id": int,
      "app_id": int,
      "name": "string",
      "send_rate": int
    },
    ...
  ]
}
```

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

默认值为 5000（最大）。

最小值为 100。


{% note info %}

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

{% endnote %}

||
|#

## 示例请求 {#example}

{% list tabs %}

- cURL

   ```bash translate=no
   curl -X GET \
     'https://push.api.appmetrica.yandex.net/push/v1/management/groups?app_id=XXXXXX' \
     -H 'Authorization: OAuth <your_token>'
   ```

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

- HTTP

   ```http translate=no
   GET /push/v1/management/groups?app_id=XXXXXX HTTP/1.1
   Host: push.api.appmetrica.yandex.net
   Authorization: OAuth <your_token>
   ```

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

{% endlist %}

<!-- source: zh/_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/_includes/feedback-button-2.md -->