---
title: "付费墙命令"
description: "Adapty CLI 命令，用于列出、读取、创建和更新付费墙，以及列出展示付费墙的版位。"
---

> **AI agents**: to search Adapty docs faster and with fewer tokens, install the Adapty skills: `npx adapty skills install --yes`

这些 Adapty CLI 命令用于管理[付费墙](paywalls)及每个付费墙所销售的产品。

## adapty paywalls list

列出应用的所有[付费墙](paywalls)。

```bash
adapty paywalls list --app <app-id>
```

| 标志 | 是否必填 | 描述 |
|---|---|---|
| `--app` | 是 | 应用 ID（UUID） |

支持[分页标志](developer-cli-reference#global-flags)。

## adapty paywalls get

获取特定[付费墙](paywalls)的详细信息。

```bash
adapty paywalls get --app <app-id> <paywall-id>
```

| 参数 | 描述 |
|---|---|
| `paywall-id` | 付费墙 ID（UUID） |

| 标志 | 是否必填 | 描述 |
|---|---|---|
| `--app` | 是 | 应用 ID（UUID） |

## adapty paywalls create

创建一个新的[付费墙](paywalls)。

```bash
adapty paywalls create --app <app-id> --title "Default Paywall" --product-id <product-id>
```

| 标志 | 是否必填 | 描述 |
|---|---|---|
| `--app` | 是 | App ID（UUID） |
| `--title` | 是 | 付费墙标题 |
| `--product-id` | 是 | [产品](product) ID（UUID）。重复使用可添加多个产品：`--product-id <id1> --product-id <id2>` |

## adapty paywalls update \{#adapty-paywalls-update\}

替换现有[付费墙](paywalls)的所有字段。

:::important
付费墙一旦与版位关联，其产品便无法更改。如需在已上线的付费墙中使用不同产品，请创建新的付费墙，并更新版位使其指向新付费墙。
:::

```bash
adapty paywalls update --app <app-id> <paywall-id> --title "Default Paywall" --product-id <product-id>
```

此命令会替换付费墙的所有字段，包括完整的产品列表。

| 参数 | 描述 |
|---|---|
| `paywall-id` | 付费墙 ID（UUID） |

| 参数 | 是否必填 | 说明 |
|---|---|---|
| `--app` | 是 | 应用 ID（UUID） |
| `--title` | 是 | 付费墙标题 |
| `--product-id` | 是 | [产品](product) ID（UUID）。如需添加多个产品，请重复使用：`--product-id <id1> --product-id <id2>` |

## adapty paywalls placements

列出当前使用指定[付费墙](paywalls)的所有[版位](placements)。

```bash
adapty paywalls placements --app <app-id> <paywall-id>
```

| 参数 | 说明 |
|---|---|
| `paywall-id` | 付费墙 ID（UUID） |

| 标志 | 是否必填 | 说明 |
|---|---|---|
| `--app` | 是 | 应用 ID（UUID） |

在替换付费墙之前，使用此命令可以查看哪些版位会受到影响。

此列表中的条目不包含 `is_active` 字段。如需读取版位的激活状态，请使用 [`placements list`](developer-cli-placements#adapty-placements-list) 或 [`placements get`](developer-cli-placements#adapty-placements-get)。

## 下一步 \{#whats-next\}

- [命令参考](developer-cli-reference) — 所有 CLI 主题、全局标志和分页标志。