139 lines
3.2 KiB
Markdown
139 lines
3.2 KiB
Markdown
---
|
||
title: Poll
|
||
description: 表示被附加到嘟文的投票。
|
||
menu:
|
||
docs:
|
||
parent: entities
|
||
aliases: [
|
||
"/entities/poll",
|
||
"/entities/Poll",
|
||
"/api/entities/poll",
|
||
"/api/entities/Poll",
|
||
]
|
||
---
|
||
|
||
## 示例
|
||
|
||
```json
|
||
{
|
||
"id": "34830",
|
||
"expires_at": "2019-12-05T04:05:08.302Z",
|
||
"expired": true,
|
||
"multiple": false,
|
||
"votes_count": 10,
|
||
"voters_count": null,
|
||
"voted": true,
|
||
"own_votes": [
|
||
1
|
||
],
|
||
"options": [
|
||
{
|
||
"title": "accept",
|
||
"votes_count": 6
|
||
},
|
||
{
|
||
"title": "deny",
|
||
"votes_count": 4
|
||
}
|
||
],
|
||
"emojis": []
|
||
}
|
||
```
|
||
|
||
## 属性
|
||
|
||
### `id` {#id}
|
||
|
||
**描述:** 数据库中投票的ID。\
|
||
**类型:** 字符串（从整数转换而来，但不保证是数字）\
|
||
**版本历史:**\
|
||
2.8.0 - 添加
|
||
|
||
### `expires_at` {#expires_at}
|
||
|
||
**描述:** 投票结束的时间。\
|
||
**类型:** {{<nullable>}} 字符串 ([Datetime](/api/datetime-format#datetime))，如果投票永不结束，则为 null\
|
||
**版本历史:**\
|
||
2.8.0 - 添加
|
||
|
||
### `expired` {#expired}
|
||
|
||
**描述:** 投票当前是否已结束？\
|
||
**类型:** 布尔值\
|
||
**版本历史:**\
|
||
2.8.0 - 添加
|
||
|
||
### `multiple` {#multiple}
|
||
|
||
**描述:** 投票是否允许多选？\
|
||
**类型:** 布尔值\
|
||
**版本历史:**\
|
||
2.8.0 - 添加
|
||
|
||
### `votes_count` {#votes_count}
|
||
|
||
**描述:** 投票收到的票数。\
|
||
**类型:** 整数\
|
||
**版本历史:**\
|
||
2.8.0 - 添加
|
||
|
||
### `voters_count` {#voters_count}
|
||
|
||
**描述:** 在一个多选投票中，有多少个独立账户进行了投票。\
|
||
**类型:** {{<nullable>}} 整数，如果 `multiple` 为 false，则为 null。\
|
||
**版本历史:**\
|
||
2.8.0 - 添加
|
||
|
||
### `options` {#options}
|
||
|
||
**描述:** 投票的选项。\
|
||
**类型:** [Poll::Option](#Option) 数组\
|
||
**版本历史:**\
|
||
2.8.0 - 添加
|
||
|
||
### `emojis` {#emojis}
|
||
|
||
**描述:** 用于渲染投票选项的自定义表情。\
|
||
**类型:** [CustomEmoji]({{< relref "entities/CustomEmoji" >}}) 数组\
|
||
**版本历史:**\
|
||
2.8.0 - 添加
|
||
|
||
### `voted` {{%optional%}} {#voted}
|
||
|
||
**描述:** 当使用用户令牌调用对应的 API 时，该令牌的授权用户是否已投票？\
|
||
**类型:** 布尔值\
|
||
**版本历史:**\
|
||
2.8.0 - 添加
|
||
|
||
### `own_votes` {{%optional%}} {#own_votes}
|
||
|
||
**描述:** 当使用用户令牌调用对应的 API 时，该令牌的授权用户选择了哪些选项？ 包含 `options` 的索引值数组。\
|
||
**类型:** 整数数组\
|
||
**版本历史:**\
|
||
2.8.0 - 添加
|
||
|
||
## Poll::Option 属性 {#Option}
|
||
|
||
### `title` {#option-title}
|
||
|
||
**描述:** 投票选项的文本值。\
|
||
**类型:** 字符串\
|
||
**版本历史:**\
|
||
2.8.0 - 添加
|
||
|
||
#### `votes_count` {#option-votes_count}
|
||
|
||
**描述:** 此选项收到的总票数。\
|
||
**类型:** {{<nullable>}} 整数，如果结果尚未发布，则为 null。\
|
||
**版本历史:**\
|
||
2.8.0 - 添加
|
||
|
||
## 参见
|
||
|
||
{{< page-relref ref="entities/Status#poll" caption="嘟文 (`poll` 属性)" >}}
|
||
|
||
{{< page-relref ref="methods/polls" caption="polls API 方法" >}}
|
||
|
||
{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/serializers/rest/poll_serializer.rb" caption="app/serializers/rest/poll_serializer.rb" >}}
|
||
|
||
{{< translation-status-zh-cn raw_title="Poll" raw_link="/entities/Poll/" last_translation_time="2025-04-21" raw_commit="6addd5cf525adec1859f48c52dafcfe1f96e558a">}}
|