接口参考

本页由 proto descriptor 与 docs/llms-metadata.json 自动生成，不会与契约漂移。 面向 AI 的等价内容见 llms-full.txt； 原始 proto 与其它语言的 stub 生成见 grpc/llms-full.txt。

通用约定

• 一端点一 RPC：写方法入参覆盖该端点全部可写字段；没有字段级 setter，也没有跨端点聚合。 Login 是唯一例外（跨端点状态机，需原子地产出并验证会话）。
• 完整状态往返：除 Login 外每个请求的首个字段都是 state，响应也带回刷新后的 state。
• proto3 optional：标 optional 的字段区分「不传」与「传空值」，不要用 "" / 0 / 空集合代替未传。
• 鉴权：gRPC metadata x-twitter-api-key + 请求消息里的 state。

AccountSecurityApi

AccountSecurityApi 是账号安全的接口面（passkey/活体/自托管备份/存款条码）。

BeginBiometricLiveness

• Python：account.security.begin_biometric_liveness
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：改变本账号的安全/备份/活体会话状态
• 说明：账号安全（passkey/活体/自托管备份/存款条码）。features 待真机试探。尚未真机验收。

请求 SecurityEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 SecurityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

BeginPalmVerification

身份验证流：

• Python：account.security.begin_palm_verification
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：推进身份/年龄验证流程
• 说明：身份验证流（palm/selfie/identity）。真机需完整验证流程（token/image 由调用方提供）。features 待真机试探。尚未真机验收。

请求 PalmTokenRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
token (#2)	string	-	-

响应 SecurityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreateFaceLivenessSession

• Python：account.security.create_face_liveness_session
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：改变本账号的安全/备份/活体会话状态
• 说明：账号安全（passkey/活体/自托管备份/存款条码）。features 待真机试探。尚未真机验收。

请求 SecurityEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 SecurityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

DeleteSelfCustodyBackup

• Python：account.security.delete_self_custody_backup
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：改变本账号的安全/备份/活体会话状态
• 说明：账号安全（passkey/活体/自托管备份/存款条码）。features 待真机试探。尚未真机验收。

请求 SecurityEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 SecurityAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

FaceLivenessResults

• Python：account.security.face_liveness_results
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：账号安全（passkey/活体/自托管备份/存款条码）。features 待真机试探。尚未真机验收。

请求 FaceLivenessResultsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
session_id (#2)	string	-	-

响应 SecurityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

FetchSelfCustodyBackup

• Python：account.security.fetch_self_custody_backup
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：账号安全（passkey/活体/自托管备份/存款条码）。features 待真机试探。尚未真机验收。

请求 SecurityEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 SecurityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

FinishBiometricLiveness

• Python：account.security.finish_biometric_liveness
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：改变本账号的安全/备份/活体会话状态
• 说明：账号安全（passkey/活体/自托管备份/存款条码）。features 待真机试探。尚未真机验收。

请求 BiometricFinishRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
nonce (#2)	string	-	-
face_id_passed (#3)	bool	-	-

响应 SecurityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

FinishPalmVerification

• Python：account.security.finish_palm_verification
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：推进身份/年龄验证流程
• 说明：身份验证流（palm/selfie/identity）。真机需完整验证流程（token/image 由调用方提供）。features 待真机试探。尚未真机验收。

请求 PalmFinishRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
nonce (#2)	string	-	-
palm_passed (#3)	bool	-	-
token (#4)	string	-	-

响应 SecurityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GenerateCashDepositBarcode

• Python：account.security.generate_cash_deposit_barcode
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：改变本账号的安全/备份/活体会话状态
• 说明：账号安全（passkey/活体/自托管备份/存款条码）。features 待真机试探。尚未真机验收。

请求 SecurityEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 SecurityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

Passkeys

• Python：account.security.passkeys
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：账号安全（passkey/活体/自托管备份/存款条码）。features 待真机试探。尚未真机验收。

请求 SecurityRestIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 SecurityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

PublicKeys

• Python：account.security.public_keys
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：账号安全（passkey/活体/自托管备份/存款条码）。features 待真机试探。尚未真机验收。

请求 SecurityPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	结构化入参的 GraphQL 变量 JSON（透传）

响应 SecurityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

SelfCustodyBackupStatus

• Python：account.security.self_custody_backup_status
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：账号安全（passkey/活体/自托管备份/存款条码）。features 待真机试探。尚未真机验收。

请求 SecurityEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 SecurityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

SelfieAgeVerificationStatus

• Python：account.security.selfie_age_verification_status
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：推进身份/年龄验证流程
• 说明：身份验证流（palm/selfie/identity）。真机需完整验证流程（token/image 由调用方提供）。features 待真机试探。尚未真机验收。

请求 SelfieStatusRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
transaction_id (#2)	string	-	-

响应 SecurityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

StartIdentityVerification

• Python：account.security.start_identity_verification
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：推进身份/年龄验证流程
• 说明：身份验证流（palm/selfie/identity）。真机需完整验证流程（token/image 由调用方提供）。features 待真机试探。尚未真机验收。

请求 IdentityVerificationRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
verification_flow (#2)	string	-	-
success_url (#3)	string	-	-
error_url (#4)	string	-	-

响应 SecurityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

StartSelfieAgeVerification

• Python：account.security.start_selfie_age_verification
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：推进身份/年龄验证流程
• 说明：身份验证流（palm/selfie/identity）。真机需完整验证流程（token/image 由调用方提供）。features 待真机试探。尚未真机验收。

请求 SelfieRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
image_id (#2)	string	-	-

响应 SecurityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

UploadSelfCustodyBackup

• Python：account.security.upload_self_custody_backup
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：改变本账号的安全/备份/活体会话状态
• 说明：账号安全（passkey/活体/自托管备份/存款条码）。features 待真机试探。尚未真机验收。

请求 SelfCustodyUploadRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
ciphertext_base64 (#2)	string	-	-

响应 SecurityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

AdsApi

AdsApi 是广告推广的接口面。

AudienceEstimates

• Python：account.ads.audience_estimates
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：内容/发现类。features 待真机试探。尚未真机验收。

请求 ContentPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 ContentRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

Budgets

• Python：account.ads.budgets
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：内容/发现类。features 待真机试探。尚未真机验收。

请求 AdsBudgetsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
country_code (#2)	string	-	-

响应 ContentRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreateCampaign

• Python：account.ads.create_campaign
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：改变本账号偏好/设置/推广活动
• 说明：内容/发现类。features 待真机试探。尚未真机验收。

请求 ContentPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 ContentRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

DefaultLocation

• Python：account.ads.default_location
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：内容/发现类。features 待真机试探。尚未真机验收。

请求 AdsLocationRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
ads_account_id (#2)	string	-	-
country_code (#3)	string	-	-
language_code (#4)	string	-	-

响应 ContentRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

AndroidApi

AndroidApi 是 Android 客户端协议的接口面。一端点 = 一 RPC； Login 是受控的跨端点例外（一个必须原子地铸造 + 验证会话凭据的登录状态机）。

Login

Login 执行完整的 Android 冷启动登录并返回完整的 AndroidAccountState。 调用方必须持久化返回的设备 —— 后续 RPC 不得重新生成它。

• Python：x.android.AndroidClient.login
• 类型：write，幂等：否
• 状态：✅ 已验收（2026-09-07）
• 成功判据：返回的 AndroidAccountState.session 中 user_id / screen_name 与登录账号一致，且服务端已用 account/settings.json 正面复核同一账号。HTTP 2xx 或响应里出现某个 token 字段都不作为成功判据。
• 副作用：在 X 平台创建一个新的登录会话，可能触发风控与设备绑定；每次调用消耗一次账号登录频次
• 说明：跨端点登录状态机，是「一端点一 RPC」的唯一受控例外；每个 RPC 只执行一次完整冷启动并随机选择一台 weight>0 金标。重试、换代理 Session、退避与账号锁属于调用方职责，Python SDK 与 Go server 均不在内部再次登录。调用方必须持久化返回的完整状态（含设备），后续 RPC 禁止重新生成设备。2FA 账号优先传 totp_seed（base32 密钥）而不是 totp（当前码）：服务端在真正执行 2FA 步骤时才算码，避免调用方算完后码在途中过期；两者同时传时 totp 优先。失败时读取标准 gRPC status details：FailureDetail 用于账号处置与重试决策，AndroidFailureContext 用于本次登录步骤和失败检查点；禁止解析错误文案。

请求 LoginRequest

字段	类型	约束	说明
username (#1)	string	-	-
password (#2)	string	-	-
totp (#3)	string	-	totp 是当前的 2FA 验证码；账号没有 2FA 时为空。 优先用 totp_seed：调用方算出的码可能在传输途中就过期。
version (#4)	string	optional	version 选择客户端 build（默认最新）；可选。
proxy (#5)	ProxyConfig（见消息定义）	-	proxy 只表示 SOCKS5H；目标域名固定由代理解析，避免服务端 DNS 泄漏。 不传即直连。用户名与密码必须同时设置或同时省略。
attest_account_id (#6)	string	optional	attest_account_id 在 guest 阶段绑定 attestation；可选。
totp_seed (#7)	string	optional	totp_seed 是 base32 的 2FA 密钥。服务端在真正执行 2FA 步骤那一刻才算码， 从而消除调用方自算 totp 带来的「请求还没到码就过期了」竞态。 设置了 totp 时忽略本字段。明文 —— 仅服务端使用，绝不写日志。

响应 LoginResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

BookmarkApi

BookmarkApi 是 Android 书签的接口面（api.x.com GraphQL）。

Add

Add 把一条推文加入书签。

• Python：account.bookmark.add
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：把该推文加入本账号书签
• 说明：尚未真机验收。 加书签（BookmarkAddMutation）。

请求 BookmarkTweetRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 BookmarkAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

AddTweetToCollection

AddTweetToCollection 把一条推文加入指定收藏夹。

• Python：account.bookmark.add_to_collection
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：把该推文归入指定收藏夹
• 说明：尚未真机验收。

请求 BookmarkCollectionTweetRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
collection_id (#2)	string	-	-
tweet_id (#3)	string	-	-

响应 BookmarkAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

Collection

Collection 返回某收藏夹里的帖（原始 JSON）。

• Python：account.bookmark.collection
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：尚未真机验收。 某收藏夹里的帖（BookmarkCollectionTimelineQuery）。features 待真机试探。

请求 BookmarkCollectionRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
collection_id (#2)	string	-	-

响应 BookmarkRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

Collections

Collections 返回全部收藏夹列表（原始 JSON）。

• Python：account.bookmark.collections
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：尚未真机验收。 全部收藏夹列表（GetBookmarkCollectionsQuery）。features 待真机试探。

请求 BookmarkListRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 BookmarkRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreateCollection

CreateCollection 新建一个书签收藏夹（返回含新收藏夹 id 的原始 JSON）。

• Python：account.bookmark.create_collection
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：新建一个书签收藏夹
• 说明：尚未真机验收。 返回含新收藏夹 id 的原始 JSON。

请求 BookmarkCollectionNameRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
name (#2)	string	-	-

响应 BookmarkRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

DeleteCollection

DeleteCollection 删除一个书签收藏夹。

• Python：account.bookmark.delete_collection
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：删除一个书签收藏夹及其归类关系
• 说明：尚未真机验收。

请求 BookmarkCollectionRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
collection_id (#2)	string	-	-

响应 BookmarkAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

List

List 返回我的书签列表（原始 JSON）。

• Python：account.bookmark.list
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：尚未真机验收。 我的书签列表（BookmarksTimelineQuery）。features 待真机试探。

请求 BookmarkListRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 BookmarkRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

Remove

Remove 把一条推文移出书签。

• Python：account.bookmark.remove
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：把该推文移出本账号书签
• 说明：尚未真机验收。 移除书签（BookmarkRemoveMutation）。

请求 BookmarkTweetRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 BookmarkAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

Search

Search 在书签内搜索（原始 JSON）。

• Python：account.bookmark.search
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：尚未真机验收。 在书签内搜索（BookmarksSearchTimelineQuery）。features 待真机试探。

请求 BookmarkSearchRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
query (#2)	string	-	-

响应 BookmarkRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

UpdateCollection

UpdateCollection 重命名一个书签收藏夹。

• Python：account.bookmark.update_collection
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：重命名一个书签收藏夹
• 说明：尚未真机验收。

请求 BookmarkCollectionUpdateRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
collection_id (#2)	string	-	-
name (#3)	string	-	-

响应 BookmarkAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

CommunitiesApi

CommunitiesApi 是 Android 社区的接口面（api.x.com GraphQL）。

DetailTimeline

DetailTimeline 某社区详情时间线（rest_id）。

• Python：account.communities.detail_timeline
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：社区 Communities。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 CommunityRestIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 CommunityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ExploreTimeline

ExploreTimeline 按话题浏览社区（topic_id）。

• Python：account.communities.explore_timeline
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：社区 Communities。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 CommunityTopicRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
topic_id (#2)	string	-	-

响应 CommunityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

Get

Get 读社区详情（community_rest_id）。

• Python：account.communities.get
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：社区 Communities。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 CommunityRestIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 CommunityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

HashtagSearch

HashtagSearch 在社区内按标签搜索（variables 透传）。

• Python：account.communities.hashtag_search
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：社区 Communities。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 CommunityPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 CommunityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

Join

Join 加入一个社区。

• Python：account.communities.join
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：加入该社区
• 说明：社区 Communities。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 CommunityIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
community_id (#2)	string	-	-

响应 CommunityAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

Joined

Joined 读某用户已加入的社区（user_id + count）。

• Python：account.communities.joined
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：社区 Communities。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 CommunityJoinedRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-
count (#3)	int32	-	-

响应 CommunityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

Leave

Leave 退出一个社区。

• Python：account.communities.leave
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：退出该社区
• 说明：社区 Communities。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 CommunityIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
community_id (#2)	string	-	-

响应 CommunityAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

MediaTimeline

MediaTimeline 某社区媒体时间线（rest_id）。

• Python：account.communities.media_timeline
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：社区 Communities。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 CommunityRestIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 CommunityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

PopularByTopic

PopularByTopic 按话题拉热门社区。

• Python：account.communities.popular_by_topic
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：社区 Communities。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 CommunityPopularRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
topic_id (#2)	string	-	-
count (#3)	int32	-	-

响应 CommunityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

RankedTimeline

RankedTimeline 排序后的社区时间线。

• Python：account.communities.ranked_timeline
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：社区 Communities。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 CommunityEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 CommunityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

SearchCommunities

SearchCommunities 搜索社区。

• Python：account.communities.search
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：社区 Communities。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 CommunitySearchRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
query (#2)	string	-	-

响应 CommunityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

Timeline

Timeline 社区主时间线。

• Python：account.communities.timeline
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：社区 Communities。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 CommunityEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 CommunityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

UserTopics

UserTopics 读用户社区话题（无参）。

• Python：account.communities.user_topics
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：社区 Communities。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 CommunityEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 CommunityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

DmApi

DmApi 是 Android DM/XChat 读查询的接口面（api.x.com GraphQL）。 结构化入参一律经 variables_json 透传（不臆造形状）。

AcceptMessageRequestMutation

• Python：account.dm.accept_message_request_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

AddWelcomeMessageToConversationMutation

• Python：account.dm.add_welcome_message_to_conversation_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

AddXChatPublicKeyMutation

• Python：account.dm.add_x_chat_public_key_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

AvPermissions

• Python：account.dm.av_permissions
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：DM/XChat 读查询，不带 action_signatures（非 E2EE 阻塞）；消息内容 E2EE 需密钥态解开。features/入参形状待真机核对。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ClearGrokConversations

• Python：account.dm.clear_grok_conversations
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ConnectPage

• Python：account.dm.connect_page
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：DM/XChat 读查询，不带 action_signatures（非 E2EE 阻塞）；消息内容 E2EE 需密钥态解开。features/入参形状待真机核对。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ConnectTabTimeline

• Python：account.dm.connect_tab_timeline
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：DM/XChat 读查询，不带 action_signatures（非 E2EE 阻塞）；消息内容 E2EE 需密钥态解开。features/入参形状待真机核对。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ConversationKeyChangeEvents

• Python：account.dm.conversation_key_change_events
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：DM/XChat 读查询，不带 action_signatures（非 E2EE 阻塞）；消息内容 E2EE 需密钥态解开。features/入参形状待真机核对。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ConversationPage

• Python：account.dm.conversation_page
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：DM/XChat 读查询，不带 action_signatures（非 E2EE 阻塞）；消息内容 E2EE 需密钥态解开。features/入参形状待真机核对。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ConversationTimeline

• Python：account.dm.conversation_timeline
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：DM/XChat 读查询，不带 action_signatures（非 E2EE 阻塞）；消息内容 E2EE 需密钥态解开。features/入参形状待真机核对。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

DeleteXChatPublicKeyMutation

• Python：account.dm.delete_x_chat_public_key_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

DmBlockMutation

• Python：account.dm.dm_block_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

DmUnblockMutation

• Python：account.dm.dm_unblock_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

FinalizeXChatMediaUploadMutation

• Python：account.dm.finalize_x_chat_media_upload_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GenerateXChatTokenMutation

• Python：account.dm.generate_x_chat_token_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GrokDeleteConversationMutation

• Python：account.dm.grok_delete_conversation_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GrokDeleteMessageMutation

• Python：account.dm.grok_delete_message_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GrokRenameConversationMutation

• Python：account.dm.grok_rename_conversation_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GrokSearchPage

• Python：account.dm.grok_search_page
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：DM/XChat 读查询，不带 action_signatures（非 E2EE 阻塞）；消息内容 E2EE 需密钥态解开。features/入参形状待真机核对。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GroupInviteDetails

• Python：account.dm.group_invite_details
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：DM/XChat 读查询，不带 action_signatures（非 E2EE 阻塞）；消息内容 E2EE 需密钥态解开。features/入参形状待真机核对。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GroupJoinRequests

• Python：account.dm.group_join_requests
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：DM/XChat 读查询，不带 action_signatures（非 E2EE 阻塞）；消息内容 E2EE 需密钥态解开。features/入参形状待真机核对。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

InboxPageConversationData

• Python：account.dm.inbox_page_conversation_data
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：DM/XChat 读查询，不带 action_signatures（非 E2EE 阻塞）；消息内容 E2EE 需密钥态解开。features/入参形状待真机核对。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

InboxPageRequest

• Python：account.dm.inbox_page_request
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：DM/XChat 读查询，不带 action_signatures（非 E2EE 阻塞）；消息内容 E2EE 需密钥态解开。features/入参形状待真机核对。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

InitialXChatPage

• Python：account.dm.initial_xchat_page
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：DM/XChat 读查询，不带 action_signatures（非 E2EE 阻塞）；消息内容 E2EE 需密钥态解开。features/入参形状待真机核对。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

InitializeGroupConversationMutation

• Python：account.dm.initialize_group_conversation_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

InitializeXChatMediaUploadMutation

• Python：account.dm.initialize_x_chat_media_upload_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

MarkMessageRequestsSeenMutation

• Python：account.dm.mark_message_requests_seen_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

MessageEventsBySequenceId

• Python：account.dm.message_events_by_sequence_id
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：DM/XChat 读查询，不带 action_signatures（非 E2EE 阻塞）；消息内容 E2EE 需密钥态解开。features/入参形状待真机核对。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

MessageEventsPage

• Python：account.dm.message_events_page
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：DM/XChat 读查询，不带 action_signatures（非 E2EE 阻塞）；消息内容 E2EE 需密钥态解开。features/入参形状待真机核对。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

MessageReadTimestamps

• Python：account.dm.message_read_timestamps
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：DM/XChat 读查询，不带 action_signatures（非 E2EE 阻塞）；消息内容 E2EE 需密钥态解开。features/入参形状待真机核对。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

MessageRequestsPage

• Python：account.dm.message_requests_page
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：DM/XChat 读查询，不带 action_signatures（非 E2EE 阻塞）；消息内容 E2EE 需密钥态解开。features/入参形状待真机核对。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ReportFrankedMessageMutation

• Python：account.dm.report_franked_message_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

SendMessageCreateMutation

• Python：account.dm.send_message_create_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

SendMessageEventMutation

• Python：account.dm.send_message_event_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

Settings

• Python：account.dm.settings
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：DM/XChat 读查询，不带 action_signatures（非 E2EE 阻塞）；消息内容 E2EE 需密钥态解开。features/入参形状待真机核对。尚未真机验收。

请求 DmEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

UpdateXChatUserRealmStateMutation

• Python：account.dm.update_x_chat_user_realm_state_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

XChatAcceptEnrollmentMutation

• Python：account.dm.x_chat_accept_enrollment_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

XChatCompleteEnrollmentMutation

• Python：account.dm.x_chat_complete_enrollment_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

XChatCreateEnrollmentSessionMutation

• Python：account.dm.x_chat_create_enrollment_session_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

XChatDenyEnrollmentMutation

• Python：account.dm.x_chat_deny_enrollment_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

XChatGetEnrollmentSessionMutation

• Python：account.dm.x_chat_get_enrollment_session_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

XChatInitiatePasscodeRetrievalMutation

• Python：account.dm.x_chat_initiate_passcode_retrieval_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

XChatSendEnrollmentEncryptedKeysMutation

• Python：account.dm.x_chat_send_enrollment_encrypted_keys_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

XChatSendEnrollmentPublicKeyMutation

• Python：account.dm.x_chat_send_enrollment_public_key_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

XChatSendGrokMessagePlaintextMutation

• Python：account.dm.x_chat_send_grok_message_plaintext_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变 DM/XChat 会话/消息/密钥/注册状态
• 说明：DM/XChat 写，不带 action_signatures（非该机制阻塞）；发消息内容 E2EE 由调用方加密。variables_json 透传。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

XChatTypeahead

• Python：account.dm.typeahead
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：DM/XChat 读查询，不带 action_signatures（非 E2EE 阻塞）；消息内容 E2EE 需密钥态解开。features/入参形状待真机核对。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

XChatUsersByIds

• Python：account.dm.users_by_ids
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：DM/XChat 读查询，不带 action_signatures（非 E2EE 阻塞）；消息内容 E2EE 需密钥态解开。features/入参形状待真机核对。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

XChatUsersByScreenName

• Python：account.dm.users_by_screen_name
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：DM/XChat 读查询，不带 action_signatures（非 E2EE 阻塞）；消息内容 E2EE 需密钥态解开。features/入参形状待真机核对。尚未真机验收。

请求 DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

FinanceApi

FinanceApi 是金融行情的接口面。

AssetData

• Python：account.finance.asset_data
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：内容/发现类。features 待真机试探。尚未真机验收。

请求 FinanceAssetRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
asset_symbol (#2)	string	-	-
currency_code (#3)	string	-	-

响应 ContentRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ChartCandlesBatch

• Python：account.finance.chart_candles_batch
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：内容/发现类。features 待真机试探。尚未真机验收。

请求 FinanceAssetRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
asset_symbol (#2)	string	-	-
currency_code (#3)	string	-	-

响应 ContentRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ChartData

• Python：account.finance.chart_data
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：内容/发现类。features 待真机试探。尚未真机验收。

请求 FinanceChartRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
asset_symbol (#2)	string	-	-
timeframe (#3)	string	-	-
candle_size (#4)	string	-	-
currency_code (#5)	string	-	-

响应 ContentRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ChartLinesBatch

• Python：account.finance.chart_lines_batch
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：内容/发现类。features 待真机试探。尚未真机验收。

请求 FinanceAssetRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
asset_symbol (#2)	string	-	-
currency_code (#3)	string	-	-

响应 ContentRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GrokApi

GrokApi 是 Grok AI 的接口面。Enable/Disable 需 action_signatures（E2EE），见批 6。

GrokComposePromptRevisions

• Python：account.grok.compose_prompt_revisions
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：内容/发现类。features 待真机试探。尚未真机验收。

请求 ContentEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 ContentRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GrokHistory

• Python：account.grok.history
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：内容/发现类。features 待真机试探。尚未真机验收。

请求 GrokHistoryRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
cursor (#2)	string	-	-

响应 ContentRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GrokHome

• Python：account.grok.home
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：内容/发现类。features 待真机试探。尚未真机验收。

请求 ContentEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 ContentRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

SetGrokMemory

• Python：account.grok.set_memory
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：改变本账号偏好/设置/推广活动
• 说明：内容/发现类。features 待真机试探。尚未真机验收。

请求 GrokMemoryRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
allow (#2)	bool	-	-

响应 ContentAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

SetGrokPreferences

• Python：account.grok.set_preferences
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：改变本账号偏好/设置/推广活动
• 说明：内容/发现类。features 待真机试探。尚未真机验收。

请求 GrokPreferencesRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
grok_mode (#2)	string	-	-
grok_model_id (#3)	string	-	-

响应 ContentAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

JobsApi

JobsApi 是招聘的接口面。

CompanyJobs

• Python：account.jobs.company_jobs
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：内容/发现类。features 待真机试探。尚未真机验收。

请求 JobsCompanyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
screen_name (#2)	string	-	-

响应 ContentRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ListApi

ListApi 是 Android 列表管理的接口面（api.x.com GraphQL）。

AllSubscribedLists

AllSubscribedLists 读某用户订阅的全部列表（user_id）。

• Python：account.lists.all_subscribed
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：列表 List。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 ListUserRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-

响应 ListRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreateList

CreateList 新建一个列表（返回含新列表 id 的原始 JSON）。

• Python：account.lists.create
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：新建一个列表
• 说明：新建列表，返回含新列表 id 的原始 JSON。 列表 List。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 ListCreateRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
name (#2)	string	-	-
is_private (#3)	bool	-	-
description (#4)	string	-	-

响应 ListRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

DeleteList

DeleteList 删除一个列表。

• Python：account.lists.delete
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：删除该列表
• 说明：列表 List。features 待真机试探。尚未真机验收。

请求 ListIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
list_id (#2)	string	-	-

响应 ListAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

GetListById

GetListById 读列表详情（rest_id）。

• Python：account.lists.get_by_id
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：列表 List。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 ListRestIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 ListRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ListAddMember

ListAddMember 把一个用户加入列表。

• Python：account.lists.add_member
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：把用户加入列表
• 说明：列表 List。features 待真机试探。尚未真机验收。

请求 ListMemberRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
list_id (#2)	string	-	-
user_id (#3)	string	-	-

响应 ListAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

ListCreateRecommendedUsers

ListCreateRecommendedUsers 读新建列表时的推荐用户（rest_id）。

• Python：account.lists.create_recommended_users
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：列表 List。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 ListRestIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 ListRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ListDeleteBanner

ListDeleteBanner 删除列表横幅图。

• Python：account.lists.delete_banner
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：删除列表横幅图
• 说明：列表 List。features 待真机试探。尚未真机验收。

请求 ListIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
list_id (#2)	string	-	-

响应 ListAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

ListEditRecommendedUsers

ListEditRecommendedUsers 读编辑列表时的推荐用户（rest_id）。

• Python：account.lists.edit_recommended_users
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：列表 List。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 ListRestIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 ListRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ListManagement

ListManagement 读列表管理时间线（无目标 id）。

• Python：account.lists.management
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：列表 List。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 ListEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 ListRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ListMembers

ListMembers 读列表成员（rest_id）。

• Python：account.lists.members
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：列表 List。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 ListRestIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 ListRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ListMembership

ListMembership 读列表归属（rest_id）。

• Python：account.lists.membership
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：列表 List。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 ListRestIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 ListRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ListMute

ListMute 静音一个列表。

• Python：account.lists.mute
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：静音该列表
• 说明：列表 List。features 待真机试探。尚未真机验收。

请求 ListIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
list_id (#2)	string	-	-

响应 ListAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

ListOwnerships

ListOwnerships 读某用户拥有的列表（user_id）。

• Python：account.lists.ownerships
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：列表 List。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 ListUserRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-

响应 ListRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ListProductSubscriptions

ListProductSubscriptions 读列表产品订阅（无参）。

• Python：account.lists.product_subscriptions
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：列表 List。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 ListEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 ListRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ListPutBanner

ListPutBanner 设置列表横幅图（list_id + media_id）。

• Python：account.lists.put_banner
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：设置列表横幅图
• 说明：列表 List。features 待真机试探。尚未真机验收。

请求 ListBannerRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
list_id (#2)	string	-	-
media_id (#3)	string	-	-

响应 ListAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

ListRemoveMember

ListRemoveMember 把一个用户移出列表。

• Python：account.lists.remove_member
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：把用户移出列表
• 说明：列表 List。features 待真机试探。尚未真机验收。

请求 ListMemberRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
list_id (#2)	string	-	-
user_id (#3)	string	-	-

响应 ListAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

ListSubscribe

ListSubscribe 订阅一个列表。

• Python：account.lists.subscribe
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：订阅该列表
• 说明：列表 List。features 待真机试探。尚未真机验收。

请求 ListIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
list_id (#2)	string	-	-

响应 ListAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

ListSubscribers

ListSubscribers 读列表订阅者（rest_id）。

• Python：account.lists.subscribers
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：列表 List。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 ListRestIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 ListRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ListUnmute

ListUnmute 取消静音一个列表。

• Python：account.lists.unmute
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：取消静音该列表
• 说明：列表 List。features 待真机试探。尚未真机验收。

请求 ListIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
list_id (#2)	string	-	-

响应 ListAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

ListUnsubscribe

ListUnsubscribe 取消订阅一个列表。

• Python：account.lists.unsubscribe
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：取消订阅该列表
• 说明：列表 List。features 待真机试探。尚未真机验收。

请求 ListIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
list_id (#2)	string	-	-

响应 ListAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

ListsByUser

ListsByUser 读某列表的时间线（rest_id）。

• Python：account.lists.by_user
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：列表 List。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 ListRestIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 ListRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

SuggestedLists

SuggestedLists 读推荐列表（无目标 id）。

• Python：account.lists.suggested
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：列表 List。features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 ListEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 ListRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

UpdateList

UpdateList 更新列表名称/隐私/描述。

• Python：account.lists.update
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：更新列表名称/隐私/描述
• 说明：列表 List。features 待真机试探。尚未真机验收。

请求 ListUpdateRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
list_id (#2)	string	-	-
is_private (#3)	bool	-	-
new_name (#4)	string	-	-
new_description (#5)	string	-	-

响应 ListAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

MediaApi

MediaApi 是 Android 媒体上传的接口面（upload.x.com + api.x.com GraphQL）。

CardPreviewFromUrl

CardPreviewFromUrl 从 URL 读卡片预览/Jetfuel。

• Python：account.media.card_preview_from_url
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：媒体读扩展。features 待真机试探。尚未真机验收。

请求 MediaUrlRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
url (#2)	string	-	-

响应 MediaRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

EmbedMediaPreview

EmbedMediaPreview 读嵌入媒体预览（rest_id）。

• Python：account.media.embed_preview
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：媒体读扩展。features 待真机试探。尚未真机验收。

请求 MediaRestIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 MediaRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GifCategory

GifCategory 按分类枚举 GIF。

• Python：account.media.gif_category
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：媒体读扩展。features 待真机试探。尚未真机验收。

请求 GifCategoryRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
category (#2)	string	-	-
image_format (#3)	string	-	-

响应 MediaRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GifSearch

媒体读扩展（返回原始 GraphQL JSON）： GifSearch 搜索 GIF。

• Python：account.media.gif_search
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：媒体读扩展。features 待真机试探。尚未真机验收。

请求 GifSearchRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
query (#2)	string	-	-
image_format (#3)	string	-	-

响应 MediaRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GrokMediaHistory

GrokMediaHistory 读 Grok 媒体历史（cursor）。

• Python：account.media.grok_media_history
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：媒体读扩展。features 待真机试探。尚未真机验收。

请求 MediaCursorRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
cursor (#2)	string	-	-

响应 MediaRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

JetfuelAttachmentComposer

JetfuelAttachmentComposer 读 Jetfuel 附件编辑器（view）。

• Python：account.media.jetfuel_composer
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：媒体读扩展。features 待真机试探。尚未真机验收。

请求 MediaViewRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
view (#2)	string	-	-

响应 MediaRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

SetMediaMetadata

SetMediaMetadata 给已上传的媒体设置 alt text（无障碍描述）。

• Python：account.media.set_metadata
• 类型：write，幂等：是
• 状态：✅ 已验收（2026-08-19）
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：为已上传媒体写入 alt text，发帖后对读屏用户可见
• 说明：已真机验收（2026-08-19）：alt_text.text 的嵌套形状被上游接受。须在 media_id 用于发帖之前调用。

请求 SetMediaMetadataRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
media_id (#2)	string	-	-
alt_text (#3)	string	-	无障碍描述文本

响应 SetMediaMetadataResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

SetVideoDownloads

SetVideoDownloads 开关视频下载偏好。

• Python：account.media.set_video_downloads
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：开关本账号视频下载偏好
• 说明：视频下载偏好。features 待真机试探。尚未真机验收。

请求 MediaBoolRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
allow (#2)	bool	-	-

响应 SetMediaMetadataResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

UploadMedia

UploadMedia 上传图片：分片 INIT→APPEND→FINALIZE，返回给 CreatePost 用的 media_id。返回刷新后的状态（attest 已重新铸造）。

• Python：account.media.upload
• 类型：write，幂等：否
• 状态：✅ 已验收（2026-08-19）
• 成功判据：响应 media_id 非空。
• 副作用：在 X 媒体服务上创建一份待引用的媒体对象
• 说明：图片链路已真机验收（2026-08-19）。★上游在 FINALIZE 阶段拒绝退化尺寸图片：1×1 PNG 会返回 media type unrecognized，INIT/APPEND 均正常通过、错误只在最后一步暴露，且与 media_category 是否传值无关；须传能真正解码出像素的图片。视频路径（UploadVideo）仍未验收。

请求 UploadMediaRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
data (#2)	bytes	-	原始图片字节
mime_type (#3)	string	-	默认 image/jpeg
media_category (#4)	string	-	默认 tweet_image

响应 UploadMediaResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	刷新后的往返状态（宪章 §3）
media_id (#2)	string	-	-

UploadVideo

UploadVideo 上传视频：分片上传后轮询 STATUS 直到转码就绪，返回 media_id。

• Python：account.media.upload_video
• 类型：write，幂等：否
• 状态：✅ 已验收（2026-08-19）
• 成功判据：返回非空 media_id，且视频 processing_info.state 已达 succeeded。
• 副作用：在 upload.x.com 暂存一段待发布视频，占用账号媒体配额
• 说明：分片上传 + STATUS 轮询直到转码就绪，已真机验收（2026-08-19，640x360 H.264/AAC 3 秒 mp4）。视频转码耗时不定，调用方 timeout 要给足。

请求 UploadVideoRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
data (#2)	bytes	-	原始视频字节
mime_type (#3)	string	-	默认 video/mp4
media_category (#4)	string	-	默认 tweet_video（也可 amplify_video）

响应 UploadMediaResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	刷新后的往返状态（宪章 §3）
media_id (#2)	string	-	-

ModerationApi

ModerationApi 是 Android 审核-安全的接口面（api.x.com GraphQL）。

BirdwatchHome

BirdwatchHome 读社区笔记（Birdwatch）主页（原始 JSON，无参）。

• Python：account.moderation.birdwatch_home
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：尚未真机验收。 社区笔记主页（BirdwatchHomePageQuery）。features 待真机试探。

请求 ModerationEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 ModerationRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreateFeedbackReport

CreateFeedbackReport 提交反馈举报（title + values；values 为透传 JSON）。

• Python：account.moderation.create_feedback_report
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：向平台提交一条反馈举报
• 说明：尚未真机验收。 values 结构化，由调用方透传 JSON（形状未真机核对）。

请求 FeedbackReportRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
title (#2)	string	-	-
values_json (#3)	string	-	values 的 GraphQL 变量 JSON（结构化，由调用方按上游 schema 提供；形状未真机核对）。

响应 ModerationRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ModerateTweet

ModerateTweet 隐藏一条回复（tweet_id）。

• Python：account.moderation.moderate_tweet
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：在本账号的回复区隐藏该回复
• 说明：尚未真机验收。 隐藏回复（ModerateTweetMutation）。

请求 ModerationTweetRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 ModerationAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

ModeratedTweets

ModeratedTweets 读某用户被隐藏的回复列表（rest_id，原始 JSON）。

• Python：account.moderation.moderated_tweets
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：尚未真机验收。 被隐藏回复列表（ModeratedTweetTimelineQuery）。共用 featTimeline。

请求 ModerationRestIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 ModerationRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ReportSpam

ReportSpam 举报一条帖子为垃圾（tweet_id 即上游 post_id）。

• Python：account.moderation.report_spam
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：向平台举报该帖为垃圾
• 说明：尚未真机验收。 上游变量名 post_id。

请求 ModerationTweetRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 ModerationAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

SendUrtFeedback

SendUrtFeedback 发送 URT 反馈（encoded_feedback_request + is_undo）。

• Python：account.moderation.send_urt_feedback
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：提交 URT 反馈信号，影响推荐
• 说明：尚未真机验收。 encoded_feedback_request 为上游不透明串。

请求 UrtFeedbackRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
encoded_feedback_request (#2)	string	-	上游给的不透明串
is_undo (#3)	bool	-	-

响应 ModerationAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

UnmoderateTweet

UnmoderateTweet 取消隐藏一条回复（tweet_id）。

• Python：account.moderation.unmoderate_tweet
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：取消隐藏该回复
• 说明：尚未真机验收。

请求 ModerationTweetRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 ModerationAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

MoneyApi

MoneyApi 是 Android x-money 的接口面（api.x.com GraphQL）。

ActivateIssuedCardsWithChallenge

• Python：account.money.activate_issued_cards_with_challenge
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

AddPaymentMethod

• Python：account.money.add_payment_method
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CancelPaymentRequestTransfer

• Python：account.money.cancel_payment_request_transfer
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CancelPaymentTransactionById

• Python：account.money.cancel_payment_transaction_by_id
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CancelPaymentTransfer

• Python：account.money.cancel_payment_transfer
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ClaimPaymentTransfer

• Python：account.money.claim_payment_transfer
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ClaimPaymentTransferLink

• Python：account.money.claim_payment_transfer_link
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ConfirmUnrecognizedPayment

• Python：account.money.confirm_unrecognized_payment
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreateCheckDeposit

• Python：account.money.create_check_deposit
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreateCheckUploadSession

• Python：account.money.create_check_upload_session
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreateDepositPaymentTransaction

• Python：account.money.create_deposit_payment_transaction
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreateDirectDepositSwitchingSession

• Python：account.money.create_direct_deposit_switching_session
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreateInternalTransferPaymentTransaction

• Python：account.money.create_internal_transfer_payment_transaction
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreateIssuedCheck

• Python：account.money.create_issued_check
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreateOutgoingInternationalWire

• Python：account.money.create_outgoing_international_wire
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreateOutgoingWire

• Python：account.money.create_outgoing_wire
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreatePaymentAuthToken

• Python：account.money.create_payment_auth_token
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreatePaymentBankCardLinkingSession

• Python：account.money.create_payment_bank_card_linking_session
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreatePaymentFinancialInstitutionLinkingSession

• Python：account.money.create_payment_financial_institution_linking_session
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreatePaymentFinancialInstitutionUpdateSession

• Python：account.money.create_payment_financial_institution_update_session
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreatePaymentMethodSession

• Python：account.money.create_payment_method_session
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreateTransferLinkTransaction

• Python：account.money.create_transfer_link_transaction
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreateTransferPaymentTransaction

• Python：account.money.create_transfer_payment_transaction
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreateWithdrawalPaymentTransaction

• Python：account.money.create_withdrawal_payment_transaction
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreatorSubsManageInfoQuery

• Python：account.money.creator_subs_manage_info_query
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreatorSubsProductQuery

• Python：account.money.creator_subs_product_query
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

DeletePaymentMethod

• Python：account.money.delete_payment_method
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

FinishPaymentTwoFactorAuthChallenge

• Python：account.money.finish_payment_two_factor_auth_challenge
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GetCardPreview

• Python：account.money.get_card_preview
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 卡片预览。variables_json 透传，尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GetClaims

• Python：account.money.get_claims
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GetPaymentBankCardLinkingSession

• Python：account.money.get_payment_bank_card_linking_session
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GetPaymentCustomerActions

• Python：account.money.get_payment_customer_actions
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GetPaymentCustomerPendingConsents

• Python：account.money.get_payment_customer_pending_consents
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GetPaymentEligibility

• Python：account.money.get_payment_eligibility
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GetPaymentHomeData

• Python：account.money.get_payment_home_data
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GetPaymentInvitationDetails

• Python：account.money.get_payment_invitation_details
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GetPaymentNearestPlaces

• Python：account.money.get_payment_nearest_places
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GetPaymentRecentParticipants

• Python：account.money.get_payment_recent_participants
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GetPaymentTransactionResultById

• Python：account.money.get_payment_transaction_result_by_id
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GetPaymentTransactionStatusUpdateById

• Python：account.money.get_payment_transaction_status_update_by_id
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GetPaymentTransactions

• Python：account.money.get_payment_transactions
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GetPaymentTransferLinkDetails

• Python：account.money.get_payment_transfer_link_details
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GetPaymentUser

• Python：account.money.get_payment_user
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GetPaymentWireBankDetails

• Python：account.money.get_payment_wire_bank_details
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

HomeTimelineSubscriptions

• Python：account.money.home_timeline_subscriptions
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

InAppPurchaseIntentCreate

• Python：account.money.in_app_purchase_intent_create
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

InAppPurchaseRedeemOffer

• Python：account.money.in_app_purchase_redeem_offer
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

LockIssuedCard

• Python：account.money.lock_issued_card
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

MarkDirectDepositSwitchingSessionCompleted

• Python：account.money.mark_direct_deposit_switching_session_completed
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

PaymentGetGrokTransactionSearchById

• Python：account.money.payment_get_grok_transaction_search_by_id
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

PaymentInitiateGrokTransactionSearch

• Python：account.money.payment_initiate_grok_transaction_search
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

PaymentOffboard

• Python：account.money.payment_offboard
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

PaymentReonboard

• Python：account.money.payment_reonboard
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

PaymentsActiveCardPaymentAuthentications

• Python：account.money.payments_active_card_payment_authentications
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

PaymentsLinkPayoutAccount

• Python：account.money.payments_link_payout_account
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

PaymentsRespondToCardPaymentAuthentication

• Python：account.money.payments_respond_to_card_payment_authentication
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

PaymentsSendPhoneVerificationCode

• Python：account.money.payments_send_phone_verification_code
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

PaymentsVerifyPhone

• Python：account.money.payments_verify_phone
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

PrefillPaymentCustomerInfo

• Python：account.money.prefill_payment_customer_info
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

PremiumHubQuery

• Python：account.money.premium_hub_query
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

PremiumObfuscatedIdQuery

• Python：account.money.premium_obfuscated_id_query
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

PremiumProductCatalogQuery

• Python：account.money.premium_product_catalog_query
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

QuickPromoteBillingConfirmCardMutation

• Python：account.money.quick_promote_billing_confirm_card_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

QuickPromoteBillingDeletePaymentMethodMutation

• Python：account.money.quick_promote_billing_delete_payment_method_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

QuickPromoteBillingPaymentMethodsQuery

• Python：account.money.quick_promote_billing_payment_methods_query
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

QuickPromoteBillingSetupIntentMutation

• Python：account.money.quick_promote_billing_setup_intent_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

QuickPromoteBillingSwitchDefaultCardMutation

• Python：account.money.quick_promote_billing_switch_default_card_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

QuickPromoteIapProductsQuery

• Python：account.money.quick_promote_iap_products_query
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

QuickPromoteIapRedeemMutation

• Python：account.money.quick_promote_iap_redeem_mutation
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

RequestTransferPaymentTransaction

• Python：account.money.request_transfer_payment_transaction
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

RespondToPaymentRequestTransfer

• Python：account.money.respond_to_payment_request_transfer
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

SearchPaymentTypeahead

• Python：account.money.search_payment_typeahead
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

StartPaymentTwoFactorAuthChallenge

• Python：account.money.start_payment_two_factor_auth_challenge
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

SubscriptionJourneyConfig

• Python：account.money.subscription_journey_config
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

SubscriptionPaywallDataQuery

• Python：account.money.subscription_paywall_data_query
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

UnlockIssuedCard

• Python：account.money.unlock_issued_card
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

UpdateAudienceRewardsEntity

• Python：account.money.update_audience_rewards_entity
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

UpdateBankCardLinkingSessionSubmissionStatus

• Python：account.money.update_bank_card_linking_session_submission_status
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：更新银行卡绑定会话提交状态
• 说明：x-money 银行卡绑定会话状态更新。variables_json 透传，尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

UpdateCardPin

• Python：account.money.update_card_pin
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：更新卡片 PIN
• 说明：x-money 卡片 PIN 更新。variables_json 透传，尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

UpdatePaymentMethodLinkage

• Python：account.money.update_payment_method_linkage
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

UserInAppPurchaseRedeemV2

• Python：account.money.user_in_app_purchase_redeem_v2
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：可能改变支付/卡/转账状态
• 说明：x-money 支付/银行/转账；不带 action_signatures，但可能需支付会话/KYC 鉴权态（T2 待真机试探）。variables_json 透传。尚未真机验收。

请求 MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

NotificationApi

NotificationApi 是通知设置的接口面。

EmailSettings

• Python：account.notification.email_settings
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：内容/发现类。features 待真机试探。尚未真机验收。

请求 ContentEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 ContentRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

UpdateEmailSettings

• Python：account.notification.update_email_settings
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：改变本账号偏好/设置/推广活动
• 说明：内容/发现类。features 待真机试探。尚未真机验收。

请求 EmailSettingsUpdateRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-
settings_json (#3)	string	-	settings 的 GraphQL 变量 JSON（透传）

响应 ContentAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

PostsApi

PostsApi 是 Android 发帖 + 互动的接口面（api.x.com GraphQL）。

AddContentDisclosure

AddContentDisclosure 给某帖添加内容披露（tweet_id + 广告/AI 生成披露）。

• Python：account.posts.add_content_disclosure
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：改变帖子/草稿/翻译/披露状态
• 说明：帖子复杂长尾。features 待真机试探。尚未真机验收。

请求 ContentDisclosureRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-
advertising_disclosure (#3)	bool	-	-
ai_generated_disclosure (#4)	bool	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

AutoTranslateLanguageEnabled

AutoTranslateLanguageEnabled 查询某语言自动翻译是否开启（language）。

• Python：account.posts.auto_translate_language_enabled
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：帖子长尾只读。features 待真机试探。尚未真机验收。

请求 PostLanguageRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
language (#2)	string	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ConversationControlDelete

ConversationControlDelete 删除某帖的回复控制。

• Python：account.posts.conversation_control_delete
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：删除该帖的回复控制
• 说明：帖子长尾。features 待真机试探。尚未真机验收。

请求 EngageRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

ConversationControlPut

以下结构化入参透传（variables_json），返回 raw_json： ConversationControlPut 设置某帖的回复控制。

• Python：account.posts.conversation_control_put
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变帖子/草稿/置顶/互动状态
• 说明：帖子复杂长尾，结构化入参透传（variables_json，形状未真机核对）。尚未真机验收。

请求 PostPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ConversationControlSettings

ConversationControlSettings 读会话（回复）控制设置（无 tweet_id）。

• Python：account.posts.conversation_control_settings
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：读本账号的会话（回复）控制设置（原始 JSON）。上游变量名=无参。features 留空待真机试探；响应形状未真机核对。尚未真机验收。

请求 ConversationControlSettingsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreateDraft

CreateDraft 新建草稿。

• Python：account.posts.create_draft
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变帖子/草稿/置顶/互动状态
• 说明：帖子复杂长尾，结构化入参透传（variables_json，形状未真机核对）。尚未真机验收。

请求 PostPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreateNotePost

CreateNotePost 发长文帖。

• Python：account.posts.create_note_post
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变帖子/草稿/置顶/互动状态
• 说明：帖子复杂长尾，结构化入参透传（variables_json，形状未真机核对）。尚未真机验收。

请求 PostPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CreatePollCard

CreatePollCard 创建一张投票卡，返回 card_uri。 投票不走 GraphQL：先建卡拿 card_uri，再把它填进 CreatePostRequest.card_uri 发帖。

• Python：account.posts.create_poll_card
• 类型：write，幂等：否
• 状态：✅ 已验收（2026-08-19）
• 成功判据：响应 card_uri 非空（形如 card://…）。
• 副作用：在 X 卡片服务上创建一张投票卡
• 说明：投票不走 GraphQL：POST caps.twitter.com/v2/cards/create.json（form 单键 card_data=JSON）拿 card_uri，再填进 CreatePost.card_uri 发帖。choices 2-4 个；duration_minutes 0=默认1440，区间 [5,10080]。已真机验收（2026-08-19）。

请求 CreatePollCardRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
choices (#2)	string	repeated	choices 是 2–4 个纯文本选项，顺序即展示顺序。
duration_minutes (#3)	int32	-	duration_minutes 投票时长；0 = 客户端默认 1440（1 天）。合法区间 [5, 10080]。

响应 CreatePollCardResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
card_uri (#2)	string	-	形如 card://123…，填进 CreatePostRequest.card_uri

CreatePost

CreatePost 发布文本（+ 可选的、来自 UploadMedia 的 media_ids）。

• Python：account.posts.create
• 类型：write，幂等：否
• 状态：✅ 已验收（2026-08-11）
• 成功判据：响应 tweet.tweet_id 非空。
• 副作用：在目标账号下公开发布一条推文
• 说明：media_ids 来自 MediaApi/UploadMedia。重复调用会产生多条推文，重试前必须先确认上一次是否已成功。 作曲字段真机验收（2026-08-19）：card_uri（配 CreatePollCard）、conversation_control（mode 为 PascalCase：Verified/Community/ByInvitation/…）、geo（place_id）均已通过；semantic_core_ids 用于话题标注与发社区帖（domain_id=31/group_id=8/entity_id=社区id）。

请求 CreatePostRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
text (#2)	string	-	-
media_ids (#3)	string	repeated	-
card_uri (#4)	string	optional	形状安全的可选发帖字段（基元标量，抓包 item 304 里以显式 null 出现）。 proto3 optional = 不传则 wire 保持 null（与已验收纯文字路径字节一致）。 其余作曲字段（conversation_control/geo/exclusive/tagged_users…）为嵌套形状， 未在真机流量核实，先不暴露，见 docs/development/createpost-field-capture-checklist.md。 挂已有卡片（如 poll card 的 card://…）；不传=不挂
broadcast_to_followers (#5)	bool	optional	广播给粉丝；不传=沿用上游默认
previous_tweet_id (#6)	string	optional	previous_tweet_id：把本次发布作为对该 tweet 的编辑（edit_options.previous_tweet_id， jadx JsonEditOptionsInput 唯一字段）。不传=普通新帖（edit_options 保持 {}，字节不变）。 编辑=用新的 text/media_ids 覆盖旧帖，须在编辑窗口内且为本账号原帖。仅 CreatePost 生效。
geo (#7)	PostGeo（见消息定义）	-	嵌套作曲字段（形状由 jadx 静态解出，见上方消息定义）。不设置即保持 wire null。 地点
semantic_core_ids (#8)	PostAnnotation（见消息定义）	repeated	话题/兴趣标注
conversation_control (#9)	PostConversationControl（见消息定义）	-	谁可以回复

响应 CreatePostResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
tweet (#2)	Tweet（见消息定义）	-	-

CreateRepostV2

CreateRepostV2 转发（tweet_id + engagement_request）。

• Python：account.posts.create_repost_v2
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变帖子/草稿/置顶/互动状态
• 说明：帖子复杂长尾，结构化入参透传（variables_json，形状未真机核对）。尚未真机验收。

请求 PostPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

DeleteContentDisclosure

DeleteContentDisclosure 删除某帖的内容披露。

• Python：account.posts.delete_content_disclosure
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：删除该帖的内容披露
• 说明：帖子长尾。features 待真机试探。尚未真机验收。

请求 EngageRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

DeleteDraft

DeleteDraft 删除一条草稿（post_id）。

• Python：account.posts.delete_draft
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：改变帖子/草稿/翻译/披露状态
• 说明：帖子复杂长尾。features 待真机试探。尚未真机验收。

请求 PostDraftIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
post_id (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

DeletePost

DeletePost 按 id 删除一条推文。

• Python：account.posts.delete
• 类型：write，幂等：是
• 状态：✅ 已验收（2026-08-11）
• 成功判据：RPC 正常返回即表示请求被接受。★无法据此判断帖子此前是否存在★：真删与重复删两次响应逐字节相同（{"delete_tweet":{"__typename":"DeleteTweetResponse"}}），属上游协议限制。需确认帖子确实消失时，删除后查 UserTweets 反查。
• 副作用：永久删除目标推文，不可恢复
• 说明：对已删除的推文重复调用不会产生新的副作用。 响应经 raw_json 原样带回；不提供 deleted 布尔字段——协议给不出依据时，一个恒为 true 的字段比没有更有害。

请求 DeletePostRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 DeletePostResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	raw_json 是未经处理的 DeleteTweet data 节点。 「删掉了」与「这条帖子本来就不存在 / 不属于本账号」目前都表现为静默成功。 区分二者的响应形状尚未在真实流量上采集，所以这里先原样带回而不是猜一个 结构化结论（charter interview #8：关键字段 + 保留 raw）。 TODO(协议核对): 置信度=未确认; 真机采集后在此基础上增加 deleted / not_found， raw_json 保留作兜底。

DeletePostV2

帖子复杂长尾： DeletePostV2 删除一条帖（DeletePostMutation 新变体，tweet_id）。

• Python：account.posts.delete_v2
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：改变帖子/草稿/翻译/披露状态
• 说明：帖子复杂长尾。features 待真机试探。尚未真机验收。

请求 EngageRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

DeleteRepostV2

DeleteRepostV2 取消转发（DeleteRepostMutation，tweet_id）。

• Python：account.posts.delete_repost_v2
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：改变帖子/草稿/翻译/披露状态
• 说明：帖子复杂长尾。features 待真机试探。尚未真机验收。

请求 EngageRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

Dislike

Dislike 给一条帖子点踩「不感兴趣」（tweet_id 即上游 post_id）。

• Python：account.posts.dislike
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：对该帖标记「不感兴趣」，影响推荐
• 说明：尚未真机验收。 上游变量名为 post_id（非 tweet_id）。go/x 注记真机「不感兴趣」走 REST feedback.json，本 GraphQL 变体真机 200 尚未确认。

请求 EngageRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

DraftPosts

DraftPosts 读草稿列表（无参）。

• Python：account.posts.drafts
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：帖子长尾只读。features 待真机试探。尚未真机验收。

请求 PostEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

EditDraft

EditDraft 编辑草稿。

• Python：account.posts.edit_draft
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变帖子/草稿/置顶/互动状态
• 说明：帖子复杂长尾，结构化入参透传（variables_json，形状未真机核对）。尚未真机验收。

请求 PostPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

EditHistory

EditHistory 一条帖子的编辑历史时间线。

• Python：account.posts.edit_history
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：一条帖子的编辑历史时间线（原始 JSON）。上游变量名=rest_id。features 留空待真机试探；响应形状未真机核对。尚未真机验收。

请求 PostByIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

EditablePosts

EditablePosts 读可编辑的帖（无参）。

• Python：account.posts.editable
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：帖子长尾只读。features 待真机试探。尚未真机验收。

请求 PostEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ExclusivePostFollow

ExclusivePostFollow 开启对某用户的独家帖关注（target_user_id）。

• Python：account.posts.exclusive_follow
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：开启对该用户的独家帖关注
• 说明：帖子长尾。features 待真机试探。尚未真机验收。

请求 PostTargetRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
target_user_id (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

ExclusivePostUnfollow

ExclusivePostUnfollow 关闭独家帖关注（target_user_id）。

• Python：account.posts.exclusive_unfollow
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：关闭独家帖关注
• 说明：帖子长尾。features 待真机试探。尚未真机验收。

请求 PostTargetRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
target_user_id (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

FavoriteV2

FavoriteV2 点赞（tweet_id + engagement_request）。

• Python：account.posts.favorite_v2
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变帖子/草稿/置顶/互动状态
• 说明：帖子复杂长尾，结构化入参透传（variables_json，形状未真机核对）。尚未真机验收。

请求 PostPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

FollowRetweets

FollowRetweets 开启对某用户的转发通知（target_user_id）。

• Python：account.posts.follow_retweets
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：开启对该用户的转发通知
• 说明：帖子长尾。features 待真机试探。尚未真机验收。

请求 PostTargetRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
target_user_id (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

GetPostById

帖子读扩展（返回原始 GraphQL JSON）： GetPostById 按 id 读单条帖子（发帖查证 / 存活监控）。

• Python：account.posts.get_by_id
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：按 id 读单条帖子（发帖查证/存活监控）（原始 JSON）。上游变量名=rest_id。features 留空待真机试探；响应形状未真机核对。尚未真机验收。

请求 PostByIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

IsPostHighlighted

IsPostHighlighted 查询某帖是否已被精选。

• Python：account.posts.is_highlighted
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：查询某帖是否已被精选（原始 JSON）。上游变量名=postId。features 留空待真机试探；响应形状未真机核对。尚未真机验收。

请求 PostByIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

Like

Like 给一条推文点赞。

• Python：account.posts.like
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：在目标推文上留下本账号的点赞记录，对方可见
• 说明：尚未真机验收。重复点赞不会叠加。

请求 EngageRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

ParodyLabelSettings

ParodyLabelSettings 读恶搞标签设置（无参）。

• Python：account.posts.parody_label_settings
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：帖子长尾只读。features 待真机试探。尚未真机验收。

请求 PostEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

Pin

Pin 把自己的一条推文置顶到资料页（tweet_id）。

• Python：account.posts.pin
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：把该推文置顶到本账号资料页，替换此前的置顶
• 说明：尚未真机验收。 置顶自己的推文（pin_tweet）。go/x 已于 2026-08-16 真机验证 200（无 features）。

请求 EngageRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

PinTimeline

PinTimeline 置顶一个时间线。

• Python：account.posts.pin_timeline
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变帖子/草稿/置顶/互动状态
• 说明：帖子复杂长尾，结构化入参透传（variables_json，形状未真机核对）。尚未真机验收。

请求 PostPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

PinnableTimelines

PinnableTimelines 读可置顶的时间线（无参）。

• Python：account.posts.pinnable_timelines
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：帖子长尾只读。features 待真机试探。尚未真机验收。

请求 PostEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

PinnedTimelines

PinnedTimelines 读已置顶的时间线（无参）。

• Python：account.posts.pinned_timelines
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：帖子长尾只读。features 待真机试探。尚未真机验收。

请求 PostEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

PostHighlightsAdd

帖子长尾（干净输入子集）： PostHighlightsAdd 把一条帖加入个人精选。

• Python：account.posts.highlights_add
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：把该帖加入个人精选
• 说明：帖子长尾。features 待真机试探。尚未真机验收。

请求 EngageRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

PostHighlightsDelete

PostHighlightsDelete 把一条帖移出个人精选。

• Python：account.posts.highlights_delete
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：把该帖移出个人精选
• 说明：帖子长尾。features 待真机试探。尚未真机验收。

请求 EngageRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

Quote

Quote 以引用某条推文的形式发文本（返回新推文）。

• Python：account.posts.quote
• 类型：write，幂等：否
• 状态：✅ 已验收（2026-08-19）
• 成功判据：响应 tweet.tweet_id 非空。
• 副作用：公开发布一条引用推文
• 说明：已真机验收（2026-08-19）。★必须提供 quoted_screen_name★：上游只接受 https://twitter.com/{screen_name}/status/{id} 这种带作者的永久链接，匿名的 /i/web/status/{id} 会被拒为 attachment_url parameter is invalid. (44)。

请求 QuoteRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
quoted_tweet_id (#2)	string	-	-
text (#3)	string	-	-
media_ids (#4)	string	repeated	-
card_uri (#5)	string	optional	-
broadcast_to_followers (#6)	bool	optional	-
quoted_screen_name (#7)	string	-	★必填★ 被引用推文作者的 screen_name（不带 @）。 真机实测上游只接受 https://twitter.com/{screen_name}/status/{id} 这种带作者的 永久链接；匿名的 /i/web/status/{id} 会被拒为 attachment_url parameter is invalid. (44)，所以光有 tweet_id 拼不出合法链接。
geo (#8)	PostGeo（见消息定义）	-	-
semantic_core_ids (#9)	PostAnnotation（见消息定义）	repeated	-
conversation_control (#10)	PostConversationControl（见消息定义）	-	-

响应 CreatePostResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
tweet (#2)	Tweet（见消息定义）	-	-

Reply

Reply 以回复某条推文的形式发文本（返回新推文）。

• Python：account.posts.reply
• 类型：write，幂等：否
• 状态：✅ 已验收（2026-08-19）
• 成功判据：响应 tweet.tweet_id 非空。
• 副作用：在目标推文下公开发布一条回复
• 说明：已真机验收（2026-08-19，含带图回复与 exclude_reply_user_ids）。exclude_reply_user_ids 留空即提及全部。

请求 ReplyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
in_reply_to_tweet_id (#2)	string	-	-
text (#3)	string	-	-
media_ids (#4)	string	repeated	-
card_uri (#5)	string	optional	与 CreatePostRequest 同名字段语义一致 —— 三个入口发的是同一个 CreatePost operation，可写字段必须对齐，不允许只给其中一个开口子。
broadcast_to_followers (#6)	bool	optional	-
exclude_reply_user_ids (#7)	string	repeated	exclude_reply_user_ids：回复时不提及的 user_id；留空 = 提及全部（wire 为 []）。
geo (#8)	PostGeo（见消息定义）	-	-
semantic_core_ids (#9)	PostAnnotation（见消息定义）	repeated	-
conversation_control (#10)	PostConversationControl（见消息定义）	-	-

响应 CreatePostResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
tweet (#2)	Tweet（见消息定义）	-	-

ReplyDeviceFollow

ReplyDeviceFollow 开启对某用户回复的设备关注（target_user_id）。

• Python：account.posts.reply_device_follow
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：开启对该用户回复的设备关注
• 说明：帖子长尾。features 待真机试探。尚未真机验收。

请求 PostTargetRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
target_user_id (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

ReplyDeviceUnfollow

ReplyDeviceUnfollow 关闭对某用户回复的设备关注（target_user_id）。

• Python：account.posts.reply_device_unfollow
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：关闭对该用户回复的设备关注
• 说明：帖子长尾。features 待真机试探。尚未真机验收。

请求 PostTargetRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
target_user_id (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

Reposters

Reposters 转发了某帖的用户时间线。

• Python：account.posts.reposters
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：转发了某帖的用户时间线（原始 JSON）。上游变量名=postId。features 留空待真机试探；响应形状未真机核对。尚未真机验收。

请求 PostByIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

Retweet

Retweet 转发一条推文。

• Python：account.posts.retweet
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：在本账号时间线公开转发目标推文
• 说明：尚未真机验收。

请求 EngageRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

TranslatePost

TranslatePost 翻译一条帖子。

• Python：account.posts.translate
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：翻译一条帖子（原始 JSON）。上游变量名=tweet_id。features 留空待真机试探；响应形状未真机核对。尚未真机验收。

请求 PostByIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

UndoDislike

UndoDislike 取消点踩（tweet_id 即上游 post_id）。

• Python：account.posts.undo_dislike
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：取消对该帖的「不感兴趣」标记
• 说明：尚未真机验收。 上游变量名为 post_id。

请求 EngageRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

UnfavoriteV2

UnfavoriteV2 取消点赞。

• Python：account.posts.unfavorite_v2
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变帖子/草稿/置顶/互动状态
• 说明：帖子复杂长尾，结构化入参透传（variables_json，形状未真机核对）。尚未真机验收。

请求 PostPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

UnfollowRetweets

UnfollowRetweets 关闭对某用户的转发通知（target_user_id）。

• Python：account.posts.unfollow_retweets
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：关闭对该用户的转发通知
• 说明：帖子长尾。features 待真机试探。尚未真机验收。

请求 PostTargetRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
target_user_id (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

Unlike

Unlike 取消点赞。

• Python：account.posts.unlike
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：撤销本账号对目标推文的点赞
• 说明：尚未真机验收。

请求 EngageRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

UnmentionUser

UnmentionUser 把自己从某帖的 @提及 中移除。

• Python：account.posts.unmention
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：把自己从该帖的@提及中移除
• 说明：帖子长尾。features 待真机试探。尚未真机验收。

请求 EngageRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

Unpin

Unpin 取消置顶（tweet_id）。

• Python：account.posts.unpin
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：移除本账号资料页的置顶推文
• 说明：尚未真机验收。 go/x 已于 2026-08-16 真机验证 200。

请求 EngageRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

UnpinTimeline

UnpinTimeline 取消置顶时间线。

• Python：account.posts.unpin_timeline
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变帖子/草稿/置顶/互动状态
• 说明：帖子复杂长尾，结构化入参透传（variables_json，形状未真机核对）。尚未真机验收。

请求 PostPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

Unretweet

Unretweet 取消转发（tweet_id = 原始/源推文 id）。

• Python：account.posts.unretweet
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：撤销本账号对目标推文的转发
• 说明：尚未真机验收。★入参 tweet_id 必须是原始推文 id，不是转发产生的推文 id。

请求 EngageRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

UnsyncedDraftPosts

UnsyncedDraftPosts 读未同步草稿（无参）。

• Python：account.posts.unsynced_drafts
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：帖子长尾只读。features 待真机试探。尚未真机验收。

请求 PostEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

UpdateAutoTranslateLanguage

UpdateAutoTranslateLanguage 开关某语言的自动翻译（language + enable）。

• Python：account.posts.update_auto_translate_language
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：改变帖子/草稿/翻译/披露状态
• 说明：帖子复杂长尾。features 待真机试探。尚未真机验收。

请求 PostLanguageToggleRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
language (#2)	string	-	-
enable (#3)	bool	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

UpdateParodyLabel

UpdateParodyLabel 更新恶搞标签（label）。

• Python：account.posts.update_parody_label
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：改变帖子/草稿/翻译/披露状态
• 说明：帖子复杂长尾。features 待真机试探。尚未真机验收。

请求 PostLabelRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
label (#2)	string	-	-

响应 EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

UpdatePinnedTimelines

UpdatePinnedTimelines 批量更新置顶时间线。

• Python：account.posts.update_pinned_timelines
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：改变帖子/草稿/置顶/互动状态
• 说明：帖子复杂长尾，结构化入参透传（variables_json，形状未真机核对）。尚未真机验收。

请求 PostPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

SearchApi

SearchApi 是 Android 搜索建议的接口面（api.x.com GraphQL）。

FinanceSearchTags

FinanceSearchTags 搜索金融标签。

• Python：account.search.finance_tags
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：搜索金融标签。 features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 FinanceSearchRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
query (#2)	string	-	-
currency_code (#3)	string	-	-
page_size (#4)	int32	-	-

响应 SearchRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

HashtagTypeahead

HashtagTypeahead 话题标签搜索建议。

• Python：account.search.hashtag_typeahead
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：话题标签搜索建议。 features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 SearchQueryRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
query (#2)	string	-	-

响应 SearchRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

JobSearch

JobSearch 搜索职位（searchParams 透传）。

• Python：account.search.jobs
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：搜索职位（searchParams 透传）。 features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 JobSearchRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
search_params_json (#2)	string	-	searchParams 的 GraphQL 变量 JSON（透传）

响应 SearchRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

LocationTypeahead

LocationTypeahead 地点搜索建议。

• Python：account.search.location_typeahead
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：地点搜索建议。 features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 SearchQueryRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
query (#2)	string	-	-

响应 SearchRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

MentionTypeahead

MentionTypeahead 发帖器 @提及搜索建议。

• Python：account.search.mention_typeahead
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：发帖器 @提及搜索建议。 features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 SearchQueryRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
query (#2)	string	-	-

响应 SearchRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

QuickPromoteLocationSearch

QuickPromoteLocationSearch 推广广告的地点搜索。

• Python：account.search.quick_promote_location
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：推广广告地点搜索。 features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 QuickPromoteLocationRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
ads_account_id (#2)	string	-	-
query (#3)	string	-	-
language_code (#4)	string	-	-

响应 SearchRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

SearchPlaceName

SearchPlaceName 按名称 + 经纬度搜索地点。

• Python：account.search.place_name
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：按名称+经纬度搜索地点。 features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 SearchPlaceNameRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
place_name (#2)	string	-	-
latitude (#3)	double	-	-
longitude (#4)	double	-	-
max_places (#5)	int32	-	-

响应 SearchRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

Typeahead

Typeahead 综合搜索建议。

• Python：account.search.typeahead
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：综合搜索建议（SearchTypeahead）。 features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 SearchTypeaheadRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
query (#2)	string	-	-
max_count (#3)	int32	-	-

响应 SearchRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

UsersTypeahead

UsersTypeahead 用户搜索建议。

• Python：account.search.users_typeahead
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：用户搜索建议（TypeaheadUsersSearchQuery）。 features 待真机试探；响应形状未真机核对。尚未真机验收。

请求 SearchQueryRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
query (#2)	string	-	-

响应 SearchRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

SettingsApi

SettingsApi 是 Android 设置-偏好的接口面（api.x.com GraphQL）。

ResetPasscode

ResetPasscode 重置应用密码锁（无参）。

• Python：account.settings.reset_passcode
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：重置应用密码锁
• 说明：尚未真机验收。 ResetPasscodeMutation。

请求 SettingsEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 SettingsAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

SubscriberConsent

SubscriberConsent 提交订阅者同意（variables_json 透传）。

• Python：account.settings.subscriber_consent
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：提交订阅者同意
• 说明：尚未真机验收。 结构化入参透传 variables_json（形状未真机核对）。

请求 SettingsPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 SettingsAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

TwoFactorAuthSettings

TwoFactorAuthSettings 读 2FA 设置（原始 JSON，无参）。

• Python：account.settings.two_factor_auth_settings
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：尚未真机验收。 读 2FA 设置（TwoFactorAuthSettingsQuery）。features 待真机试探。

请求 SettingsEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 SettingsRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

UpdateBusinessLocationPreference

UpdateBusinessLocationPreference 更新商业地址偏好（variables_json 透传）。

• Python：account.settings.update_business_location_preference
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：更新商业地址偏好
• 说明：尚未真机验收。 结构化入参透传 variables_json。

请求 SettingsPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 SettingsAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

UpdateCustomerConsents

UpdateCustomerConsents 更新客户同意项（variables_json 透传）。

• Python：account.settings.update_customer_consents
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：更新客户同意项
• 说明：尚未真机验收。 结构化入参透传 variables_json。

请求 SettingsPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 SettingsAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

UpdateDmSettings

UpdateDmSettings 更新私信设置（variables_json 透传）。

• Python：account.settings.update_dm_settings
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：更新私信接收/回执等设置
• 说明：尚未真机验收。 结构化入参透传 variables_json。

请求 SettingsPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 SettingsAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

UpdateInferredLocationPreference

UpdateInferredLocationPreference 更新「推断位置解析」偏好（单枚举字符串）。

• Python：account.settings.update_inferred_location_preference
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：更新推断位置解析偏好
• 说明：尚未真机验收。 单枚举字符串。

请求 InferredLocationRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
preference (#2)	string	-	枚举字符串

响应 SettingsAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

SocialApi

SocialApi 是 Android 关系操作的接口面（api.x.com GraphQL）。

AcceptFollowRequest

AcceptFollowRequest 接受某用户的关注请求（私密账号）。

• Python：account.social.accept_follow_request
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：接受该用户对本（私密）账号的关注请求
• 说明：尚未真机验收。 上游变量名为 user_id。仅本账号为私密时有意义。

请求 SocialRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-

响应 SocialResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

AddSuperFollowerPrivacy

AddSuperFollowerPrivacy 把某用户加入超级关注隐私。

• Python：account.social.add_super_follower_privacy
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：把该用户加入超级关注隐私范围
• 说明：尚未真机验收。 上游变量名为 user_id。

请求 SocialRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-

响应 SocialResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

Block

Block 拉黑一个用户。

• Python：account.social.block
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：拉黑该用户；同时会解除双向关注
• 说明：尚未真机验收。 拉黑会同时移除双向关注关系。

请求 SocialRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-

响应 SocialResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

CancelFollowRequest

CancelFollowRequest 撤回对某用户发出的关注请求。

• Python：account.social.cancel_follow_request
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：撤回此前向该用户发出的关注请求
• 说明：尚未真机验收。 仅对私密账号有意义。

请求 SocialRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-

响应 SocialResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

DenyFollowRequest

DenyFollowRequest 拒绝某用户的关注请求（私密账号）。

• Python：account.social.deny_follow_request
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：拒绝该用户对本（私密）账号的关注请求
• 说明：尚未真机验收。 上游变量名为 user_id。

请求 SocialRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-

响应 SocialResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

DeviceFollow

DeviceFollow 开启对某用户的设备关注（发帖通知）。

• Python：account.social.device_follow
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：开启对该用户的设备关注，其发帖会推送通知
• 说明：尚未真机验收。

请求 SocialRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-

响应 SocialResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

DeviceUnfollow

DeviceUnfollow 关闭对某用户的设备关注。

• Python：account.social.device_unfollow
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：关闭对该用户的设备关注（发帖通知）
• 说明：尚未真机验收。

请求 SocialRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-

响应 SocialResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

Follow

Follow 关注一个用户。

• Python：account.social.follow
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：关注该用户；对方会收到通知，双方关系可见
• 说明：尚未真机验收。 关注一个用户（follow_by_rest_id_v2）。私密账号会转为「已发送关注请求」。

请求 SocialRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-

响应 SocialResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

LiveFollow

LiveFollow 开启对某用户的直播关注。

• Python：account.social.live_follow
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：开启对该用户的直播关注，其开播会推送通知
• 说明：尚未真机验收。

请求 SocialRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-

响应 SocialResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

LiveUnfollow

LiveUnfollow 关闭对某用户的直播关注。

• Python：account.social.live_unfollow
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：关闭对该用户的直播关注
• 说明：尚未真机验收。

请求 SocialRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-

响应 SocialResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

Mute

Mute 静音一个用户。

• Python：account.social.mute
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：静音该用户；本账号不再看到其内容，对方无感知
• 说明：尚未真机验收。

请求 SocialRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-

响应 SocialResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

RemoveSuperFollowerPrivacy

RemoveSuperFollowerPrivacy 把某用户移出超级关注隐私。

• Python：account.social.remove_super_follower_privacy
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：把该用户移出超级关注隐私范围
• 说明：尚未真机验收。 上游变量名为 user_id。

请求 SocialRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-

响应 SocialResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

Unblock

Unblock 解除拉黑一个用户。

• Python：account.social.unblock
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：解除对该用户的拉黑
• 说明：尚未真机验收。

请求 SocialRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-

响应 SocialResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

Unfollow

Unfollow 取消关注一个用户。

• Python：account.social.unfollow
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：取消对该用户的关注
• 说明：尚未真机验收。

请求 SocialRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-

响应 SocialResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

Unmute

Unmute 取消静音一个用户。

• Python：account.social.unmute
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：取消对该用户的静音
• 说明：尚未真机验收。

请求 SocialRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-

响应 SocialResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

SpacesApi

SpacesApi 是 Android 语音房的接口面（api.x.com GraphQL）。

AddSharing

AddSharing 给语音房添加分享（sharing 透传）。

• Python：account.spaces.add_sharing
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：改变本账号在该语音房的订阅/分享状态
• 说明：给语音房添加分享（sharing 透传）。 features 待真机试探。尚未真机验收。

请求 AddSharingRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
audio_space_id (#2)	string	-	-
sharing_json (#3)	string	-	sharing 的 GraphQL 变量 JSON（透传）

响应 SpacesAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

AuthenticatePeriscope

AuthenticatePeriscope 获取 Periscope 鉴权信息（无参）。

• Python：account.spaces.authenticate_periscope
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：Periscope 鉴权信息。 features 待真机试探。尚未真机验收。

请求 SpacesEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 SpacesRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

Broadcast

Broadcast 读直播详情（rest_id）。

• Python：account.spaces.broadcast
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：直播详情（BroadcastByRestId）。 features 待真机试探。尚未真机验收。

请求 SpaceRestIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 SpacesRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

BrowseTopics

BrowseTopics 浏览语音房话题（seed_category_id）。

• Python：account.spaces.browse_topics
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：浏览语音房话题。 features 待真机试探。尚未真机验收。

请求 SpaceTopicsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
seed_category_id (#2)	string	-	-

响应 SpacesRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ByID

ByID 读语音房详情。

• Python：account.spaces.by_id
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：语音房详情（AudiospaceByRestId）。 features 待真机试探。尚未真机验收。

请求 SpaceIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
audio_space_id (#2)	string	-	-

响应 SpacesRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

DeleteSharing

DeleteSharing 删除语音房分享。

• Python：account.spaces.delete_sharing
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：改变本账号在该语音房的订阅/分享状态
• 说明：删除语音房分享。 features 待真机试探。尚未真机验收。

请求 DeleteSharingRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
audio_space_id (#2)	string	-	-
sharing_id (#3)	string	-	-

响应 SpacesAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

SearchSpaces

SearchSpaces 搜索语音房。

• Python：account.spaces.search
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：搜索语音房（AudioSpacesSearch）。 features 待真机试探。尚未真机验收。

请求 AudioSpacesSearchRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
query (#2)	string	-	-
filter (#3)	string	-	-
num_results (#4)	int32	-	-

响应 SpacesRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

Sharings

Sharings 读语音房的分享列表。

• Python：account.spaces.sharings
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：语音房分享列表。 features 待真机试探。尚未真机验收。

请求 SpaceIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
audio_space_id (#2)	string	-	-

响应 SpacesRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

SubscribeScheduled

SubscribeScheduled 订阅一个已排期的语音房。

• Python：account.spaces.subscribe_scheduled
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：改变本账号在该语音房的订阅/分享状态
• 说明：订阅已排期语音房。 features 待真机试探。尚未真机验收。

请求 SpaceIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
audio_space_id (#2)	string	-	-

响应 SpacesAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

UnsubscribeScheduled

UnsubscribeScheduled 取消订阅已排期语音房。

• Python：account.spaces.unsubscribe_scheduled
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：改变本账号在该语音房的订阅/分享状态
• 说明：取消订阅已排期语音房。 features 待真机试探。尚未真机验收。

请求 SpaceIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
audio_space_id (#2)	string	-	-

响应 SpacesAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

TelemetryApi

TelemetryApi 是客户端埋点的接口面（完整性覆盖；调用方通常不需要）。

LogActions

• Python：account.telemetry.log_actions
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：向 X 上报客户端埋点事件
• 说明：客户端遥测埋点，完整性覆盖；调用方通常不需要。events 结构化透传。尚未真机验收。

请求 TelemetryLogRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json_string (#2)	string	-	-

响应 SecurityAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

SaveClientEvents

• Python：account.telemetry.save_client_events
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：向 X 上报客户端埋点事件
• 说明：客户端遥测埋点，完整性覆盖；调用方通常不需要。events 结构化透传。尚未真机验收。

请求 SecurityPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	结构化入参的 GraphQL 变量 JSON（透传）

响应 SecurityAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

TimelineApi

TimelineApi 是 Android 时间线读取的接口面。

DeviceFollowPosts

DeviceFollowPosts 设备关注的帖时间线（rest_id 即 userId）。

• Python：account.timeline.device_follow_posts
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：设备关注的帖时间线。共用 featTimeline。尚未真机验收。

请求 UserTweetsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

Favouriters

Favouriters 某帖的点赞者时间线。

• Python：account.timeline.favouriters
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：某帖点赞者时间线。时间线/关系补漏；features=featTimeline（同族）；入参形状未真机核对（variables_json 透传）。尚未真机验收。

请求 TimelinePassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

FriendsFollowingTimeline

FriendsFollowingTimeline 返回某用户的「你关注的人也关注了」模块（原始）。

• Python：account.timeline.friends_following
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：某用户的「你关注的人也关注了」模块（GetFriendsFollowingTimeline）。count 可选，不传由服务端套用默认值 3。features 已在 Profile.Features 实证。尚未真机验收。

请求 FriendsFollowingTimelineRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-
count (#3)	int32	optional	请求返回多少条。不传则用客户端自身的默认值（3）—— 用 optional，使「未设置」能与显式的 0 区分开（宪章 §2）。

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

HomeTimeline

HomeTimeline 返回启动时的主页 feed（原始）。

• Python：account.timeline.home
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：尚未真机验收。时间线是体量大且易变的 GraphQL 树，以 raw_json 往返，调用方自行解析所需字段。

请求 HomeTimelineRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

HomeTimelineLatest

HomeTimelineLatest 返回按时间排序的主页流（非算法流，原始）。

• Python：account.timeline.home_latest
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：按时间排序的主页流（HomeTimelineLatest，非算法流）。features 与 HomeTimeline 同族已实证；variables 沿用 HomeTimeline，真机可能需 enable_ranking 等微调。尚未真机验收。

请求 HomeTimelineRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

ImmersiveExplore

ImmersiveExplore 沉浸式浏览器 Explore 混合流。

• Python：account.timeline.immersive_explore
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：沉浸式 Explore 混合流。时间线/关系补漏；features=featTimeline（同族）；入参形状未真机核对（variables_json 透传）。尚未真机验收。

请求 TimelinePassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

ImmersiveProfile

ImmersiveProfile 沉浸式浏览器 Profile 混合流。

• Python：account.timeline.immersive_profile
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：沉浸式 Profile 混合流。时间线/关系补漏；features=featTimeline（同族）；入参形状未真机核对（variables_json 透传）。尚未真机验收。

请求 TimelinePassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

IncomingFriendships

IncomingFriendships 本账号收到的关注请求列表。

• Python：account.timeline.incoming_friendships
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：本账号收到的关注请求列表。时间线/关系补漏；features=featTimeline（同族）；入参形状未真机核对（variables_json 透传）。尚未真机验收。

请求 TimelinePassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

NotificationDetail

NotificationDetail 单条通知详情时间线。

• Python：account.timeline.notification_detail
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：单条通知详情时间线。时间线/关系补漏；features=featTimeline（同族）；入参形状未真机核对（variables_json 透传）。尚未真机验收。

请求 TimelinePassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

Notifications

Notifications 通知时间线。

• Python：account.timeline.notifications
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：通知时间线。时间线/关系补漏；features=featTimeline（同族）；入参形状未真机核对（variables_json 透传）。尚未真机验收。

请求 TimelinePassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

SearchTimeline

--- 时间线/关系补漏（结构化入参 passthrough，raw 往返）--- SearchTimeline 搜索结果时间线。

• Python：account.timeline.search_timeline
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：搜索结果时间线。时间线/关系补漏；features=featTimeline（同族）；入参形状未真机核对（variables_json 透传）。尚未真机验收。

请求 TimelinePassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

SetNotificationLastSeenCursor

SetNotificationLastSeenCursor 更新通知已读游标（mutation）。

• Python：account.timeline.set_notification_last_seen_cursor
• 类型：write，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 副作用：更新通知已读游标
• 说明：更新通知已读游标（mutation）。时间线/关系补漏；features=featTimeline（同族）；入参形状未真机核对（variables_json 透传）。尚未真机验收。

请求 TimelinePassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

TimelineById

TimelineById 按 timelineId 拉取自定义时间线。

• Python：account.timeline.timeline_by_id
• 类型：read，幂等：否
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：按 timelineId 拉自定义时间线。时间线/关系补漏；features=featTimeline（同族）；入参形状未真机核对（variables_json 透传）。尚未真机验收。

请求 TimelinePassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

UserAffiliates

UserAffiliates 某用户的关联账号时间线。

• Python：account.timeline.user_affiliates
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：某用户的关联账号时间线（原始 JSON）。入参与 UserTweets 同构、共用 featTimeline（已实证同族）。尚未真机验收。

请求 UserTweetsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

UserArticles

UserArticles 某用户的文章时间线。

• Python：account.timeline.user_articles
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：某用户的文章时间线（原始 JSON）。入参与 UserTweets 同构、共用 featTimeline（已实证同族）。尚未真机验收。

请求 UserTweetsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

UserFavorites

UserFavorites 某用户点赞过的帖时间线。

• Python：account.timeline.user_favorites
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：某用户点赞过的帖时间线（原始 JSON）。入参与 UserTweets 同构、共用 featTimeline（已实证同族）。尚未真机验收。

请求 UserTweetsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

UserHighlights

UserHighlights 返回某用户的精选帖时间线（原始）。

• Python：account.timeline.user_highlights
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：某用户的精选帖时间线（UserProfileHighlightsTimelineQuery），features 与 UserTweets 同族已实证。尚未真机验收。

请求 UserHighlightsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

UserMedia

UserMedia 某用户的媒体时间线。

• Python：account.timeline.user_media
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：某用户的媒体时间线（原始 JSON）。入参与 UserTweets 同构、共用 featTimeline（已实证同族）。尚未真机验收。

请求 UserTweetsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

UserNewReplies

UserNewReplies 某用户的新回复时间线。

• Python：account.timeline.user_new_replies
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：某用户的新回复时间线（原始 JSON）。入参与 UserTweets 同构、共用 featTimeline（已实证同族）。尚未真机验收。

请求 UserTweetsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

UserPhotos

UserPhotos 某用户的照片时间线。

• Python：account.timeline.user_photos
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：某用户的照片时间线（原始 JSON）。入参与 UserTweets 同构、共用 featTimeline（已实证同族）。尚未真机验收。

请求 UserTweetsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

UserPromoted

UserPromoted 某用户资料页的推广内容时间线。

• Python：account.timeline.user_promoted
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：某用户资料页的推广内容时间线（原始 JSON）。入参与 UserTweets 同构、共用 featTimeline（已实证同族）。尚未真机验收。

请求 UserTweetsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

UserReplies

以下资料时间线均按 rest_id 拉取，复用 UserTweetsRequest（原始）。 UserReplies 某用户的回复时间线。

• Python：account.timeline.user_replies
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：某用户的回复时间线（原始 JSON）。入参与 UserTweets 同构、共用 featTimeline（已实证同族）。尚未真机验收。

请求 UserTweetsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

UserReposts

UserReposts 某用户转发过的帖时间线。

• Python：account.timeline.user_reposts
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：某用户转发过的帖时间线（原始 JSON）。入参与 UserTweets 同构、共用 featTimeline（已实证同族）。尚未真机验收。

请求 UserTweetsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

UserSuperFollowers

UserSuperFollowers 某用户的超级关注者时间线。

• Python：account.timeline.user_super_followers
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：某用户的超级关注者时间线（原始 JSON）。入参与 UserTweets 同构、共用 featTimeline（已实证同族）。尚未真机验收。

请求 UserTweetsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

UserTweets

UserTweets 返回某用户自己的帖子时间线（原始）。

• Python：account.timeline.user_tweets
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：尚未真机验收。

请求 UserTweetsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

UserVideos

UserVideos 某用户的视频时间线。

• Python：account.timeline.user_videos
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：某用户的视频时间线（原始 JSON）。入参与 UserTweets 同构、共用 featTimeline（已实证同族）。尚未真机验收。

请求 UserTweetsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

UserWithProfileTweetsV2

UserWithProfileTweetsV2 某用户资料页帖时间线（V2）。

• Python：account.timeline.user_with_profile_tweets_v2
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：某用户资料页帖时间线 V2。共用 featTimeline。尚未真机验收。

请求 UserTweetsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

ViewerBlocking

ViewerBlocking 本账号拉黑的用户列表（无 rest_id）。

• Python：account.timeline.viewer_blocking
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：本账号拉黑的用户列表（原始 JSON，无 rest_id）。共用 featTimeline。用于运营对账（关系写操作的验证手段）。尚未真机验收。

请求 HomeTimelineRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

ViewerMuting

ViewerMuting 本账号静音的用户列表（无 rest_id）。

• Python：account.timeline.viewer_muting
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：本账号静音的用户列表（原始 JSON，无 rest_id）。共用 featTimeline。用于运营对账（关系写操作的验证手段）。尚未真机验收。

请求 HomeTimelineRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

TopicApi

TopicApi 是话题趋势的接口面。

AiTrendById

• Python：account.topic.ai_trend
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：内容/发现类。features 待真机试探。尚未真机验收。

请求 TopicTrendRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
trend_id (#2)	string	-	-

响应 ContentRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

Explore

• Python：account.topic.explore
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：内容/发现类。features 待真机试探。尚未真机验收。

请求 ContentEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 ContentRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

TopicPage

• Python：account.topic.page
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：内容/发现类。features 待真机试探。尚未真机验收。

请求 TopicPageRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 ContentRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

UsersApi

UsersApi 是 Android 资料读取的接口面。

AboutProfile

用户-资料 剩余（干净子集）： AboutProfile 读账号所在地等（rest_id）——account_based_in 的来源端点。

• Python：account.users.about_profile
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：账号所在地等（AboutProfileQuery，含 account_based_in——这是它的来源端点，UserByRestID 不返回）。 features 待真机试探。尚未真机验收。

请求 UserByRestIDRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 RawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

AboutProfileByScreenName

AboutProfileByScreenName 按 @handle 读账号所在地等。

• Python：account.users.about_profile_by_screen_name
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：按 @handle 读账号所在地等。 features 待真机试探。尚未真机验收。

请求 UserByScreenNameRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
screen_name (#2)	string	-	不带 @ 的用户名

响应 RawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

AdsStatsForViewer

AdsStatsForViewer 读广告统计（start/end 毫秒时间戳）。

• Python：account.users.ads_stats
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：广告统计。 features 待真机试探。尚未真机验收。

请求 AdsStatsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
start_timestamp_msec (#2)	int64	-	-
end_timestamp_msec (#3)	int64	-	-

响应 RawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

GetUser

GetUser 读用户资料（rest_id）。

• Python：account.users.get_user
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：用户资料（GetUserQuery）。 features 待真机试探。尚未真机验收。

请求 UserByRestIDRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 RawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

Me

Me 返回当前登录账号自己的资料。

• Python：account.users.me
• 类型：read，幂等：是
• 状态：✅ 已验收（2026-08-13）
• 成功判据：响应 user 非空且 rest_id 与当前会话账号一致。
• 说明：尚未真机验收。返回关键字段 + 原始 raw_json。 真机验收：返回账号与登录账号一致，同轮 HomeTimeline / UserTweets 非空。raw_json 中 user_result.result.legacy 含 location / created_at / protected / profile_image_url_https / suspended / needs_phone_verification。

请求 MeRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 UserResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
user (#2)	User（见消息定义）	-	-

ProfileAnalytics

ProfileAnalytics 返回 [from_time,to_time]（RFC3339 Z）区间的原始曝光数据。

• Python：account.users.profile_analytics
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：尚未真机验收。时间区间用 RFC3339 Z 格式。

请求 ProfileAnalyticsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-
from_time (#3)	string	-	RFC3339 Z
to_time (#4)	string	-	-

响应 RawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ProfileConnectionPage

ProfileConnectionPage 读资料连接页（rest_id + initial_page）。

• Python：account.users.connection_page
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：资料连接页（关注/粉丝等）。 features 待真机试探。尚未真机验收。

请求 ConnectionPageRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-
initial_page (#3)	string	-	-

响应 RawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ProfileConnectionPageByScreenName

ProfileConnectionPageByScreenName 按 @handle 读资料连接页。

• Python：account.users.connection_page_by_screen_name
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：按 @handle 读资料连接页。 features 待真机试探。尚未真机验收。

请求 ConnectionPageByNameRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
screen_name (#2)	string	-	-
initial_page (#3)	string	-	-

响应 RawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ProfileModules

ProfileModules 返回资料页模块的原始数据。

• Python：account.users.profile_modules
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：尚未真机验收。返回未经处理的 GraphQL 结构，字段随上游变动，调用方需自行做容错解析。

请求 ProfileModulesRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 RawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

QuickPromoteAdAccounts

QuickPromoteAdAccounts 读推广广告账号（无参）。

• Python：account.users.quick_promote_ad_accounts
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：推广广告账号。 features 待真机试探。尚未真机验收。

请求 UserEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 RawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

SetForYouRecommendations

SetForYouRecommendations 开关「为你推荐」偏好。

• Python：account.users.set_for_you_recommendations
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：开关「为你推荐」偏好
• 说明：用户偏好写。features 待真机试探。尚未真机验收。

请求 UserBoolRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
allow (#2)	bool	-	-

响应 UserAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

SetHideVerificationInfo

SetHideVerificationInfo 开关隐藏验证信息偏好（user_id + bool）。

• Python：account.users.set_hide_verification_info
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：开关隐藏验证信息偏好
• 说明：用户偏好写。features 待真机试探。尚未真机验收。

请求 HideVerificationRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-
hidden (#3)	bool	-	-

响应 UserAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

SetXaiDataSharing

SetXaiDataSharing 开关 Xai 数据共享偏好。

• Python：account.users.set_xai_data_sharing
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：开关 Xai 数据共享偏好
• 说明：用户偏好写。features 待真机试探。尚未真机验收。

请求 UserBoolRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
allow (#2)	bool	-	-

响应 UserAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

SetXaiPersonalization

SetXaiPersonalization 开关 Xai 个性化偏好。

• Python：account.users.set_xai_personalization
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：开关 Xai 个性化偏好
• 说明：用户偏好写。features 待真机试探。尚未真机验收。

请求 UserBoolRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
allow (#2)	bool	-	-

响应 UserAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

UserByRestID

UserByRestID 按数字 rest_id 返回资料。

• Python：account.users.by_rest_id
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 user 非空。
• 说明：尚未真机验收。入参是数字 rest_id，不是 @screen_name。

请求 UserByRestIDRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 UserResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
user (#2)	User（见消息定义）	-	-

UserByScreenName

UserByScreenName 按 @handle 查用户，返回原始 GraphQL 数据。

• Python：account.users.by_screen_name
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON，含 user_result_by_screen_name 节点。
• 说明：按 @handle 查用户（GetUserByScreenNameQuery），返回 raw_json（响应用 UserResultsFragment，形状未真机核对故不硬解析）。features 待真机试探。尚未真机验收。

请求 UserByScreenNameRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
screen_name (#2)	string	-	不带 @ 的用户名

响应 RawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

UserPreferences

UserPreferences 读用户偏好（无参）。

• Python：account.users.preferences
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：用户偏好。 features 待真机试探。尚未真机验收。

请求 UserEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 RawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

UsernameAvailability

UsernameAvailability 查询用户名可用性与建议（username）。

• Python：account.users.username_availability
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：用户名可用性与建议。 features 待真机试探。尚未真机验收。

请求 UsernameRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
username (#2)	string	-	-

响应 RawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

UsersAvatarsByIds

UsersAvatarsByIds 批量读头像（ids 透传）。

• Python：account.users.avatars_by_ids
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：批量头像（ids 透传）。 features 待真机试探。尚未真机验收。

请求 UsersAvatarsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
ids_json (#2)	string	-	ids 的 GraphQL 变量 JSON（透传）

响应 RawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

UsersByIds

UsersByIds 批量查用户（一次请求查 N 个 rest_id），返回原始 GraphQL 数据。

• Python：account.users.by_ids
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON，含 user_results_by_rest_ids 数组。
• 说明：批量查用户（GetUsersByIds），一次请求查 N 个 rest_id，直接缓解频控配额压力（L-003）。features 待真机试探。尚未真机验收。

请求 UsersByIdsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_ids (#2)	string	repeated	一批数字 user id

响应 RawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

VerificationInfo

VerificationInfo 读验证信息（rest_id）。

• Python：account.users.verification_info
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON。
• 说明：验证信息。 features 待真机试探。尚未真机验收。

请求 UserByRestIDRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

响应 RawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ViewerUser

ViewerUser 返回观察者自己的富资料节点（ViewerUserQuery）： legacy 块不携带的订阅/权益资格/创作者标志等。

• Python：account.users.viewer_user
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：响应 raw_json 为可解析的非空 JSON，且包含观察者自身节点（viewer_v2）。
• 说明：观察者自己的富资料节点（ViewerUserQuery），比 Me 多带订阅/权益资格/创作者标志等 legacy 块不携带的字段。尚未真机验收。

请求 ViewerUserRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 RawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

WriteInstalledApps

WriteInstalledApps 写已安装应用列表（slugs 透传）。

• Python：account.users.write_installed_apps
• 类型：write，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：RPC 正常返回且未抛出 gRPC 错误。
• 副作用：写已安装应用列表
• 说明：用户偏好写。features 待真机试探。尚未真机验收。

请求 InstalledAppsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
slugs_json (#2)	string	-	slugs 的 GraphQL 变量 JSON（透传）

响应 UserAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

WriteStatus

WriteStatus 只读巡检当前账号的发帖能力（是否被限成只读）。 数据源是 HomeTimeline —— X 客户端自己就是靠主页流里注入的限权横幅知道账号只读的， 因此不需要试发帖，也不产生任何副作用。 ★与本仓其余 RPC 不同：上游的「账号被封 / 被锁 / 会话失效 / 被限流」不作为 RPC 失败抛出★， 而是作为巡检结论填进 status —— 对巡检而言那是查询的结果，不是查询的失败。 只有传输层失败（代理不可达、超时、5xx、无法分类）才返回 gRPC 错误。

• Python：account.users.write_status
• 类型：read，幂等：是
• 状态：🔷 已实现，未真机验收
• 成功判据：status 非 WRITE_STATUS_UNKNOWN 即视为巡检成功。★注意 WRITE_STATUS_WRITABLE 的语义是「未检测到限权信号」，不是「已确认能发帖」★。
• 说明：只读巡检账号发帖能力，数据源是 HomeTimeline（X 客户端自己就是靠主页流注入的限权横幅判定只读的），不试发帖、无写副作用、不发遥测。★与其余 RPC 不同：上游的账号被封/被锁/会话失效/被限流不作为 RPC 失败抛出，而是填进 status★，只有传输层失败与无法分类的错误才返回 gRPC 错误；因此调用方拿不到 FailureDetail.upstream_http_status，改看响应里的 http_status。writable 是 optional bool 三态，UNKNOWN 与 RATE_LIMITED 时字段缺席（缺席 ≠ false）。reason 仅在 READ_ONLY_SUSPENDED 时为平台横幅原文，其余为固定说明文案，一律禁止解析文案做分类。★READ_ONLY_SUSPENDED 分支尚未经真机限权账号验证★：判据结构来自 jadx 12.13.0 与 web 通道实测，横幅 fixture 为构造样本，取到真机样本后需整体替换。

请求 WriteStatusRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

响应 WriteStatusResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
status (#2)	WriteStatus	-	-
writable (#3)	bool	optional	是否可发帖。三态：UNKNOWN 与 RATE_LIMITED 时字段缺席， 表示「没查到」而不是「明确不可写」—— 调用方不得把缺席当成 false，更不得当成 true。
reason (#4)	string	-	限权说明。只有 READ_ONLY_SUSPENDED 时是平台横幅原文（不翻译、不映射）； 其余状态是本服务的固定说明文案，可写时为空串。 ★仅供展示与人工研判，禁止解析它做分类★。
http_status (#5)	int32	-	上游 HomeTimeline 的 HTTP 状态码。因为上游失败在本 RPC 被转成了正常响应， 调用方拿不到 FailureDetail.upstream_http_status，这里是唯一的排障信号。
banner_entry_id (#6)	string	-	命中的限权横幅 entry_id；未命中为空。判据漂移时用于回溯。

WebAccountApi

WebAccountApi 是 Web 账号资料与设置接口面。

AccountSettings

AccountSettings 读账号设置（REST GET /1.1/account/settings.json）， 同时用作 cookie 探活：返回的 screen_name 会回填进 state。 TODO(协议核对): 置信度=高概率; 来源=Android 同 path whoami; 尚无 Web 抓包。

• Python：account.account.settings
• 类型：read，幂等：是
• 状态：✅ 已验收（2026-09-16）
• 成功判据：响应 screen_name 非空且与状态里已有 handle 一致（不一致说明这份 cookie 不是该账号的，服务端拒绝）。
• 说明：读账号设置，兼作 cookie 探活并回填 screen_name。2026-09-16 真机验收通过：GET /1.1/account/settings.json 需带 x-client-transaction-id，否则上游 404 code 34。

请求 WebStateRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-

响应 WebSettingsResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
screen_name (#2)	string	-	screen_name 来自响应，用于 cookie 探活的正面确认（web-integration-rules C7）。
raw_json (#3)	string	-	raw_json 是完整设置对象（上游回显）。
rate_limit (#4)	RateLimit（见消息定义）	-	-

UpdateAccountSettings

UpdateAccountSettings 改账号设置（REST POST 同 path）。 ★不含行为链前置请求★；推荐 WebChainApi.AccountUpdateAccountSettingsFromProfile。

• Python：account.account.update_settings
• 类型：write，幂等：是
• 状态：✅ 已验收（2026-09-16）
• 成功判据：响应 screen_name 非空（上游回显整个设置对象）。
• 副作用：修改账号设置（如 protected / geo_enabled / allow_dms_from）
• 说明：★不含行为链的前置请求★：风控看的是请求序列，漏掉前置请求的风险由调用方承担；推荐改用 WebChainApi/AccountUpdateAccountSettingsFromProfile。 2026-09-16 真机验收：作为设置链的复原步单独走过裸 RPC，写入生效。

请求 WebUpdateSettingsRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
settings (#2)	WebSettingKV（见消息定义）	repeated	-

响应 WebSettingsResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
screen_name (#2)	string	-	screen_name 来自响应，用于 cookie 探活的正面确认（web-integration-rules C7）。
raw_json (#3)	string	-	raw_json 是完整设置对象（上游回显）。
rate_limit (#4)	RateLimit（见消息定义）	-	-

UpdateProfile

UpdateProfile 改资料（REST POST /1.1/account/update_profile.json）。 ★不含行为链前置请求★；推荐 WebChainApi.AccountUpdateProfileFromProfile。

• Python：account.account.update_profile
• 类型：write，幂等：是
• 状态：✅ 已验收（2026-09-16）
• 成功判据：响应 user_id 非空（上游回显用户对象）。★HTTP 200 不是判据★：空 name 会返回 200+errors[120]。
• 副作用：修改账号昵称/简介/地点/主页链接/生日；消耗改资料配额（抓包实测 15 次 / 15 分钟 / 账号）
• 说明：★不含行为链的前置请求★：风控看的是请求序列，漏掉前置请求的风险由调用方承担；推荐改用 WebChainApi/AccountUpdateProfileFromProfile。name 不能为空。 ★协议已确认★：上游 update_profile.json 已由对应行为链真机跑通（2026-09-16）；但裸 RPC 自身的 gRPC 映射尚未单独验收。 上游协议已由对应行为链确认；2026-09-16 裸 RPC 的 gRPC 映射亦单独真机验收通过（Follow 打已关注目标幂等复验，Like/Add 实打，图片与昵称原样重提）。

请求 WebUpdateProfileRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
fields (#2)	WebProfileFields（见消息定义）	-	-

响应 WebProfileResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
user_id (#2)	string	-	成功判据：上游回显的用户对象里 id_str 非空。
screen_name (#3)	string	-	-
name (#4)	string	-	-
profile_image_url (#5)	string	-	-
profile_banner_url (#6)	string	-	-
raw_json (#7)	string	-	-
rate_limit (#8)	RateLimit（见消息定义）	-	-

UpdateProfileBanner

UpdateProfileBanner 把已上传的 media 应用为横幅（REST POST update_profile_banner.json）。 ★不含上传与前置请求★；推荐 WebChainApi.AccountUpdateProfileBannerFromProfile。

• Python：account.account.update_profile_banner
• 类型：write，幂等：是
• 状态：✅ 已验收（2026-09-16）
• 成功判据：响应 user_id 非空、profile_banner_url 为新横幅。
• 副作用：替换账号横幅
• 说明：★不含行为链的前置请求★：风控看的是请求序列，漏掉前置请求的风险由调用方承担；推荐改用 WebChainApi/AccountUpdateProfileBannerFromProfile（含上传）。上传时须带 media_category=banner_image。 ★协议已确认★：上游 update_profile_banner.json 已由对应行为链真机跑通（2026-09-16）；但裸 RPC 自身的 gRPC 映射尚未单独验收。 上游协议已由对应行为链确认；2026-09-16 裸 RPC 的 gRPC 映射亦单独真机验收通过（Follow 打已关注目标幂等复验，Like/Add 实打，图片与昵称原样重提）。

请求 WebApplyMediaRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
media_id (#2)	string	-	-

响应 WebProfileResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
user_id (#2)	string	-	成功判据：上游回显的用户对象里 id_str 非空。
screen_name (#3)	string	-	-
name (#4)	string	-	-
profile_image_url (#5)	string	-	-
profile_banner_url (#6)	string	-	-
raw_json (#7)	string	-	-
rate_limit (#8)	RateLimit（见消息定义）	-	-

UpdateProfileImage

UpdateProfileImage 把已上传的 media 应用为头像（REST POST update_profile_image.json）。 ★不含上传与前置请求★；推荐 WebChainApi.AccountUpdateProfileImageFromProfile。

• Python：account.account.update_profile_image
• 类型：write，幂等：是
• 状态：✅ 已验收（2026-09-16）
• 成功判据：响应 user_id 非空、profile_image_url 为新头像。
• 副作用：替换账号头像
• 说明：★不含行为链的前置请求★：风控看的是请求序列，漏掉前置请求的风险由调用方承担；推荐改用 WebChainApi/AccountUpdateProfileImageFromProfile（含上传）。需要先用 WebMediaApi/UploadMedia 拿 media_id。 ★协议已确认★：上游 update_profile_image.json 已由对应行为链真机跑通（2026-09-16）；但裸 RPC 自身的 gRPC 映射尚未单独验收。 上游协议已由对应行为链确认；2026-09-16 裸 RPC 的 gRPC 映射亦单独真机验收通过（Follow 打已关注目标幂等复验，Like/Add 实打，图片与昵称原样重提）。

请求 WebApplyMediaRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
media_id (#2)	string	-	-

响应 WebProfileResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
user_id (#2)	string	-	成功判据：上游回显的用户对象里 id_str 非空。
screen_name (#3)	string	-	-
name (#4)	string	-	-
profile_image_url (#5)	string	-	-
profile_banner_url (#6)	string	-	-
raw_json (#7)	string	-	-
rate_limit (#8)	RateLimit（见消息定义）	-	-

WebBookmarkApi

WebBookmarkApi 是 Web 书签接口面。

Add

Add 把一条推文加入书签（GraphQL CreateBookmark）。

• Python：account.bookmark.add
• 类型：write，幂等：是
• 状态：✅ 已验收（2026-09-16）
• 成功判据：响应 result == "Done"。
• 副作用：把该推文加入本账号书签（仅自己可见）
• 说明：★不含行为链的前置请求★：风控看的是请求序列，漏掉前置请求的风险由调用方承担；推荐改用 WebChainApi/SocialFollowFromProfile（收藏是链内附带动作）。 ★协议已确认★：上游 CreateBookmark 已由 WebChainApi/SocialFollowFromProfile 真机跑通（2026-09-16）；但裸 RPC 自身的 gRPC 映射尚未单独验收。 上游协议已由对应行为链确认；2026-09-16 裸 RPC 的 gRPC 映射亦单独真机验收通过（Follow 打已关注目标幂等复验，Like/Add 实打，图片与昵称原样重提）。

请求 WebTweetRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-
screen_name (#3)	string	-	screen_name 是推文作者的 handle，只用于装配 referer（抓包里点赞/收藏的 referer 是 https://x.com/<作者handle>）；留空则用站点根。

响应 WebAckResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
result (#2)	string	-	result 是上游返回的字符串结果（点赞 favorite_tweet / 收藏 tweet_bookmark_put，成功为 "Done"）。
rate_limit (#3)	RateLimit（见消息定义）	-	-

WebChainApi

WebChainApi 是 Web 行为链接口面。

AccountUpdateAccountSettingsFromProfile

AccountUpdateAccountSettingsFromProfile：预热 → CHECK → settings.json。

• Python：account.chain.account_update_account_settings_from_profile
• 类型：write，幂等：是
• 状态：✅ 已验收（2026-09-16）
• 成功判据：steps 里 ACCOUNT_SETTINGS 为 SUCCEEDED 且 settings.screen_name 非空。
• 副作用：修改账号设置
• 说明：行为链 RPC（宪章 §2 例外 2）：复现抓包里这次用户动作固定发出的整串请求。★返回逐步结果★——只要链开始打上游就不返回 gRPC 错误，steps 里逐步给出 成功/失败/跳过/未知/未执行；调用方必须按步骤记账，不能把部分成功当全部成功。步骤名取上游 operation/端点名。链内不睡眠、不重试、不掷骰子：间隔、限流等待、重试、概率属调用方编排。 步骤：BOOTSTRAP → USER_BY_SCREEN_NAME → ACCOUNT_SETTINGS(POST)。 2026-09-16 真机验收：翻转 display_sensitive_media，上游回显新值确认写入生效，随后复原。实测配额 180。

请求 WebChainSettingsRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
settings (#2)	WebSettingKV（见消息定义）	repeated	-

响应 WebChainSettingsResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
steps (#2)	ChainStep（见消息定义）	repeated	steps：BOOTSTRAP / USER_BY_SCREEN_NAME / ACCOUNT_SETTINGS。
settings (#3)	WebSettingsResponse（见消息定义）	-	-
account_unavailable (#4)	bool	-	-

AccountUpdateProfileBannerFromProfile

AccountUpdateProfileBannerFromProfile：同上，INIT 带 media_category=banner_image， 应用到 update_profile_banner.json。

• Python：account.chain.account_update_profile_banner_from_profile
• 类型：write，幂等：是
• 状态：✅ 已验收（2026-09-16）
• 成功判据：steps 里 UPDATE_PROFILE_BANNER 为 SUCCEEDED。
• 副作用：上传图片并替换账号横幅
• 说明：行为链 RPC（宪章 §2 例外 2）：复现抓包里这次用户动作固定发出的整串请求。★返回逐步结果★——只要链开始打上游就不返回 gRPC 错误，steps 里逐步给出 成功/失败/跳过/未知/未执行；调用方必须按步骤记账，不能把部分成功当全部成功。步骤名取上游 operation/端点名。链内不睡眠、不重试、不掷骰子：间隔、限流等待、重试、概率属调用方编排。 步骤：BOOTSTRAP → USER_BY_SCREEN_NAME → UPLOAD_MEDIA（media_category=banner_image）→ UPDATE_PROFILE_BANNER。 2026-09-16 真机验收：同上但 media_category=banner_image，横幅实际更换。实测配额 30。

请求 WebChainMediaRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
image (#2)	bytes	-	-
filename (#3)	string	-	-

响应 WebChainProfileResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
steps (#2)	ChainStep（见消息定义）	repeated	steps：BOOTSTRAP / USER_BY_SCREEN_NAME / UPLOAD_MEDIA(仅头像横幅) / UPDATE_PROFILE 等。
profile (#3)	WebProfileResponse（见消息定义）	-	profile 是动作成功时上游回显的资料；失败或未执行时为空。
media_id (#4)	string	-	media_id 是换头像/横幅链上传出的 media；改资料链为空。
account_unavailable (#5)	bool	-	account_unavailable 表示 CHECK 步判定账号不可用（__typename 不是 "User"），动作步未执行。

AccountUpdateProfileFromProfile

AccountUpdateProfileFromProfile 复现「查自己的资料 → 提交资料」： 预热 → UserByScreenName(自己) → update_profile.json。

• Python：account.chain.account_update_profile_from_profile
• 类型：write，幂等：是
• 状态：✅ 已验收（2026-09-16）
• 成功判据：steps 里 UPDATE_PROFILE 为 SUCCEEDED 且 profile.user_id 非空；account_unavailable=true 表示 CHECK 判定账号不可用、动作未执行。
• 副作用：修改账号资料；消耗改资料配额
• 说明：行为链 RPC（宪章 §2 例外 2）：复现抓包里这次用户动作固定发出的整串请求。★返回逐步结果★——只要链开始打上游就不返回 gRPC 错误，steps 里逐步给出 成功/失败/跳过/未知/未执行；调用方必须按步骤记账，不能把部分成功当全部成功。步骤名取上游 operation/端点名。链内不睡眠、不重试、不掷骰子：间隔、限流等待、重试、概率属调用方编排。 步骤：BOOTSTRAP → USER_BY_SCREEN_NAME（查自己）→ UPDATE_PROFILE。需要状态里有 screen_name。 2026-09-16 真机验收：CHECK → update_profile 走通，回显 user_id 与 cookie 账号一致。实测配额：改资料 15/15min、UserByScreenName 150/15min。

请求 WebChainUpdateProfileRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
fields (#2)	WebProfileFields（见消息定义）	-	-

响应 WebChainProfileResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
steps (#2)	ChainStep（见消息定义）	repeated	steps：BOOTSTRAP / USER_BY_SCREEN_NAME / UPLOAD_MEDIA(仅头像横幅) / UPDATE_PROFILE 等。
profile (#3)	WebProfileResponse（见消息定义）	-	profile 是动作成功时上游回显的资料；失败或未执行时为空。
media_id (#4)	string	-	media_id 是换头像/横幅链上传出的 media；改资料链为空。
account_unavailable (#5)	bool	-	account_unavailable 表示 CHECK 步判定账号不可用（__typename 不是 "User"），动作步未执行。

AccountUpdateProfileImageFromProfile

AccountUpdateProfileImageFromProfile：预热 → CHECK → 上传三段式 → update_profile_image.json。

• Python：account.chain.account_update_profile_image_from_profile
• 类型：write，幂等：是
• 状态：✅ 已验收（2026-09-16）
• 成功判据：steps 里 UPDATE_PROFILE_IMAGE 为 SUCCEEDED；UPLOAD_MEDIA 成功但应用失败时 media_id 已产生，可据此判断媒体是否已上传。
• 副作用：上传图片并替换账号头像
• 说明：行为链 RPC（宪章 §2 例外 2）：复现抓包里这次用户动作固定发出的整串请求。★返回逐步结果★——只要链开始打上游就不返回 gRPC 错误，steps 里逐步给出 成功/失败/跳过/未知/未执行；调用方必须按步骤记账，不能把部分成功当全部成功。步骤名取上游 operation/端点名。链内不睡眠、不重试、不掷骰子：间隔、限流等待、重试、概率属调用方编排。 步骤：BOOTSTRAP → USER_BY_SCREEN_NAME → UPLOAD_MEDIA → UPDATE_PROFILE_IMAGE。 2026-09-16 真机验收：CHECK → 三段式上传 → 应用，头像实际更换（回显新 profile_image_url）。实测媒体上传配额 615。

请求 WebChainMediaRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
image (#2)	bytes	-	-
filename (#3)	string	-	-

响应 WebChainProfileResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
steps (#2)	ChainStep（见消息定义）	repeated	steps：BOOTSTRAP / USER_BY_SCREEN_NAME / UPLOAD_MEDIA(仅头像横幅) / UPDATE_PROFILE 等。
profile (#3)	WebProfileResponse（见消息定义）	-	profile 是动作成功时上游回显的资料；失败或未执行时为空。
media_id (#4)	string	-	media_id 是换头像/横幅链上传出的 media；改资料链为空。
account_unavailable (#5)	bool	-	account_unavailable 表示 CHECK 步判定账号不可用（__typename 不是 "User"），动作步未执行。

SocialFollowFromProfile

SocialFollowFromProfile 复现「看目标主页 → 关注 →（点赞 → 收藏）」： 预热 → UserTweetsAndReplies(目标) → followUserMutation → FavoriteTweet → CreateBookmark。

• Python：account.chain.social_follow_from_profile
• 类型：write，幂等：是
• 状态：✅ 已验收（2026-09-16）
• 成功判据：steps 里 FOLLOW_USER_MUTATION 为 SUCCEEDED 且 follow_typename == "FollowSuccessResult"；已关注且未 force 时该步为 SKIPPED（属正常结束）。
• 副作用：关注目标用户；like=true 时给目标的一条推文点赞；bookmark=true 时收藏同一条推文；消耗关注/点赞/时间线三类配额
• 说明：行为链 RPC（宪章 §2 例外 2）：复现抓包里这次用户动作固定发出的整串请求。★返回逐步结果★——只要链开始打上游就不返回 gRPC 错误，steps 里逐步给出 成功/失败/跳过/未知/未执行；调用方必须按步骤记账，不能把部分成功当全部成功。步骤名取上游 operation/端点名。链内不睡眠、不重试、不掷骰子：间隔、限流等待、重试、概率属调用方编排。 步骤：BOOTSTRAP → USER_TWEETS_AND_REPLIES → FOLLOW_USER_MUTATION →（FAVORITE_TWEET → CREATE_BOOKMARK）。like/bookmark 是明确布尔开关。 2026-09-16 真机验收：10 个目标全部走通（1 新关注 + 9 已关注跳过，0 失败），另用 force=true 补验完整 5 步（关注 FollowSuccessResult + 点赞 + 收藏）。实测配额与抓包一致：关注 50/15min、时间线与点赞 500/15min。

请求 WebChainFollowRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
user_id (#2)	string	-	user_id 是目标用户 rest_id。
force (#3)	bool	-	force 为 true 时，即使时间线显示已关注也照发关注请求。
like (#4)	bool	-	like / bookmark 是抓包里紧跟关注的附带动作开关。★由调用方决定是否执行★—— 概率（如 0.56）在调用方掷骰子，SDK 内不出现随机概率。 bookmark 只在点赞成功后才执行（与抓包一致）。
bookmark (#5)	bool	-	-

响应 WebChainFollowResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
steps (#2)	ChainStep（见消息定义）	repeated	steps 按执行顺序给出：BOOTSTRAP / USER_TWEETS_AND_REPLIES / FOLLOW_USER_MUTATION / FAVORITE_TWEET / CREATE_BOOKMARK。
target_screen_name (#3)	string	-	-
already_following (#4)	bool	-	already_following 是执行关注之前时间线显示的关注状态。
follow_typename (#5)	string	-	follow_typename 是关注步的上游 __typename（成功为 "FollowSuccessResult"）；跳过时为空。
liked_tweet_id (#6)	string	-	liked_tweet_id 是 SDK 从时间线里随机挑中的推文；未点赞时为空。

WebMediaApi

WebMediaApi 是 Web 媒体上传接口面。

UploadMedia

UploadMedia 上传图片：三段式 INIT→APPEND→FINALIZE（必要时轮询 STATUS），返回 media_id。 三段式属单端点内的受控多请求（宪章 §2），不是行为链。

• Python：account.media.upload
• 类型：write，幂等：否
• 状态：✅ 已验收（2026-09-16）
• 成功判据：响应 media_id 非空。三段式成功码不统一（INIT 202 / APPEND 204 / FINALIZE 201），服务端按 2xx 判定。
• 副作用：在上游创建一份媒体对象（未被引用时会自行过期）
• 说明：上传图片（INIT→APPEND→FINALIZE，必要时轮询 STATUS），返回 media_id。三段式是单端点内的受控多请求，不是行为链。media_category 留空=头像，横幅传 banner_image。图片上限 5 MB。 ★协议已确认★：上游 i/media/upload.json 三段式 已由对应行为链真机跑通（2026-09-16）；但裸 RPC 自身的 gRPC 映射尚未单独验收。 上游协议已由对应行为链确认；2026-09-16 裸 RPC 的 gRPC 映射亦单独真机验收通过（Follow 打已关注目标幂等复验，Like/Add 实打，图片与昵称原样重提）。

请求 WebUploadMediaRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
image (#2)	bytes	-	image 是原图字节，上限 5 MB（抓包一致）。
filename (#3)	string	-	filename 只用于推断 media_type（扩展名），不会发给上游。
media_category (#4)	string	-	media_category 为空 = 头像；横幅传 "banner_image"（抓包一致）。

响应 WebUploadMediaResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
media_id (#2)	string	-	-
rate_limit (#3)	RateLimit（见消息定义）	-	-

WebPostsApi

WebPostsApi 是 Web 帖子互动接口面。

Like

Like 给一条推文点赞（GraphQL FavoriteTweet）。

• Python：account.posts.like
• 类型：write，幂等：是
• 状态：✅ 已验收（2026-09-16）
• 成功判据：响应 result == "Done"。
• 副作用：给该推文点赞，作者会收到通知；消耗点赞配额
• 说明：★不含行为链的前置请求★：风控看的是请求序列，漏掉前置请求的风险由调用方承担；推荐改用 WebChainApi/SocialFollowFromProfile（点赞是链内附带动作）。 ★协议已确认★：上游 FavoriteTweet 已由 WebChainApi/SocialFollowFromProfile 真机跑通（2026-09-16）；但裸 RPC 自身的 gRPC 映射尚未单独验收。 上游协议已由对应行为链确认；2026-09-16 裸 RPC 的 gRPC 映射亦单独真机验收通过（Follow 打已关注目标幂等复验，Like/Add 实打，图片与昵称原样重提）。

请求 WebTweetRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-
screen_name (#3)	string	-	screen_name 是推文作者的 handle，只用于装配 referer（抓包里点赞/收藏的 referer 是 https://x.com/<作者handle>）；留空则用站点根。

响应 WebAckResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
result (#2)	string	-	result 是上游返回的字符串结果（点赞 favorite_tweet / 收藏 tweet_bookmark_put，成功为 "Done"）。
rate_limit (#3)	RateLimit（见消息定义）	-	-

WebSocialApi

WebSocialApi 是 Web 关系操作接口面。

Follow

Follow 关注一个用户（GraphQL followUserMutation）。 ★不含行为链的前置请求★（不会先拉目标主页），风险由调用方承担； 推荐 WebChainApi.SocialFollowFromProfile。

• Python：account.social.follow
• 类型：write，幂等：是
• 状态：✅ 已验收（2026-09-16）
• 成功判据：响应 typename == "FollowSuccessResult"。★HTTP 200 不是成功判据★：失败也回 200，只是 typename 不同。
• 副作用：关注该用户；对方会收到通知；消耗关注配额（抓包实测 50 次 / 15 分钟 / 账号）
• 说明：★不含行为链的前置请求★：风控看的是请求序列，漏掉前置请求的风险由调用方承担；推荐改用 WebChainApi/SocialFollowFromProfile。 ★协议已确认★：上游 followUserMutation 已由 WebChainApi/SocialFollowFromProfile 真机跑通（2026-09-16）；但裸 RPC 自身的 gRPC 映射尚未单独验收。 上游协议已由对应行为链确认；2026-09-16 裸 RPC 的 gRPC 映射亦单独真机验收通过（Follow 打已关注目标幂等复验，Like/Add 实打，图片与昵称原样重提）。

请求 WebFollowRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
user_id (#2)	string	-	-

响应 WebFollowResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
typename (#2)	string	-	typename 是成功判据：必须为 "FollowSuccessResult"，其它值一律视为失败。
rate_limit (#3)	RateLimit（见消息定义）	-	-

WebTimelineApi

WebTimelineApi 是 Web 时间线读取接口面。

UserTweetsAndReplies

UserTweetsAndReplies 拉某用户主页的「帖子与回复」（GraphQL UserTweetsAndReplies）。

• Python：account.timeline.user_tweets_and_replies
• 类型：read，幂等：是
• 状态：✅ 已验收（2026-09-16）
• 成功判据：RPC 正常返回；tweet_ids 为该用户主页顶层推文，following 表示当前账号是否已关注。
• 说明：拉某用户主页的「帖子与回复」。2026-09-16 真机验收：features / fieldToggles 被上游接受；链内亦作为关注前的主页加载步跑通；cursor 翻页亦已验证（第 1 页 17 条 → 第 2 页 20 条不同推文）。

请求 WebUserTimelineRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
user_id (#2)	string	-	-
count (#3)	int32	-	count 为 0 时用抓包默认值 30。
cursor (#4)	string	-	TODO(协议核对): 置信度=高概率; 来源=响应里的 cursor-bottom 条目; 抓包未出现翻页请求。

响应 WebTimelineResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
tweet_ids (#2)	string	repeated	tweet_ids 是顶层 tweet-<id> 条目（与抓包工具取法一致）。
screen_name (#3)	string	-	screen_name / following 来自响应里的目标用户对象（relationship_perspectives.following）。
following (#4)	bool	-	-
next_cursor (#5)	string	-	next_cursor 是 cursor-bottom 条目的值；没有则为空。
raw_json (#6)	string	-	raw_json 是未经处理的响应（漂移兜底）。
rate_limit (#7)	RateLimit（见消息定义）	-	-

WebUsersApi

WebUsersApi 是 Web 用户读取接口面。

Followers

Followers 拉某用户的一页粉丝（GraphQL Followers）。不自动翻页，调用方用 next_cursor 继续。 置信度=已确认（2026-09-16 真机，含 cursor 翻页）; 来源=x-api-rs client.rs。

• Python：account.users.followers
• 类型：read，幂等：是
• 状态：✅ 已验收（2026-09-16）
• 成功判据：raw_json 非空且 users 中每项 user_id / screen_name 非空；next_cursor 为空表示到底。
• 说明：拉一页粉丝（GraphQL Followers）。user_id 必须是数字 rest_id（先用 UserByScreenName 换）。不自动翻页，翻页循环、间隔与限流等待归调用方；上游以 0| 开头的游标按到底处理。实测请求 count=20 时每页回 50 条；配额 50/15 分钟（翻页很快耗尽，调用方须按 rate_limit 等待）。2026-09-16 真机验收：公开账号两页，cursor 翻页生效。

请求 WebUserListRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
user_id (#2)	string	-	user_id 必须是数字 rest_id，不接受 @handle（先用 UserByScreenName 换 id）。
count (#3)	int32	-	count 为 0 时发浏览器默认值 20。★实测上游每页回 50 条（请求 count=20，2026-09-16）★，count 只是提示值。
cursor (#4)	string	-	-

响应 WebUserListResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
users (#2)	User（见消息定义）	repeated	users 是本页的 user-* 条目；两种结构（新扁平 / 旧 legacy）都取不到 name 与 screen_name 的条目会被丢弃。
next_cursor (#3)	string	-	next_cursor 为空表示没有下一页（上游以 0\| 开头的游标也按到底处理）。
raw_json (#4)	string	-	raw_json 是未经处理的响应（漂移兜底）。
rate_limit (#5)	RateLimit（见消息定义）	-	-

Following

Following 拉某用户的一页关注列表（GraphQL Following），消息与 Followers 相同。 置信度=已确认（2026-09-16 真机，含 cursor 翻页）; 来源=x-api-rs client.rs。

• Python：account.users.following
• 类型：read，幂等：是
• 状态：✅ 已验收（2026-09-16）
• 成功判据：raw_json 非空且 users 中每项 user_id / screen_name 非空；next_cursor 为空表示到底。
• 说明：拉一页关注列表（GraphQL Following），用法同 Followers。实测每页 50 条；配额 500/15 分钟。2026-09-16 真机验收：公开账号两页，cursor 翻页生效。

请求 WebUserListRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
user_id (#2)	string	-	user_id 必须是数字 rest_id，不接受 @handle（先用 UserByScreenName 换 id）。
count (#3)	int32	-	count 为 0 时发浏览器默认值 20。★实测上游每页回 50 条（请求 count=20，2026-09-16）★，count 只是提示值。
cursor (#4)	string	-	-

响应 WebUserListResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
users (#2)	User（见消息定义）	repeated	users 是本页的 user-* 条目；两种结构（新扁平 / 旧 legacy）都取不到 name 与 screen_name 的条目会被丢弃。
next_cursor (#3)	string	-	next_cursor 为空表示没有下一页（上游以 0\| 开头的游标也按到底处理）。
raw_json (#4)	string	-	raw_json 是未经处理的响应（漂移兜底）。
rate_limit (#5)	RateLimit（见消息定义）	-	-

UserByRestID

UserByRestID 按数字 rest_id 查用户（GraphQL UserByRestId，走 api.x.com）。 上游是轻量查询文档：只回 id / 名字 / handle / 头像，计数类字段为 0；id 不存在时 unavailable=true。 置信度=已确认（2026-09-16 真机）; 来源=x-api-rs gql_ops.rs。

• Python：account.users.by_rest_id
• 类型：read，幂等：是
• 状态：✅ 已验收（2026-09-16）
• 成功判据：响应 unavailable=false 且 user.user_id 等于请求的 user_id；账号冻结/不存在时 unavailable=true（不是失败）。
• 说明：按数字 rest_id 查用户（GraphQL UserByRestId，走 api.x.com/graphql，只发 variables）。上游是轻量文档：只回 id/名字/handle/头像，计数类字段为 0；响应是 data.user 直接为用户对象（无 result 包装、无 __typename）。id 不存在时上游回 200 且无 data，映射为 unavailable=true。配额 500/15 分钟。2026-09-16 真机验收：查自己，rest_id 与 twid 一致。

请求 WebUserByRestIDRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
user_id (#2)	string	-	user_id 是数字 rest_id。

响应 WebUserResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
user (#2)	User（见消息定义）	-	-
unavailable (#3)	bool	-	unavailable 表示账号冻结 / 不存在：UserByScreenName 为 __typename 不是 "User"（此时 user 仅有 screen_name）； UserByRestID 为响应缺 rest_id 或无 data（此时 user 仅有 user_id）。
typename (#4)	string	-	typename 是上游原样返回的 __typename，便于排查 unavailable 的具体形态。
rate_limit (#5)	RateLimit（见消息定义）	-	-

UserByScreenName

UserByScreenName 按 @handle 查用户资料（GraphQL UserByScreenName）。

• Python：account.users.by_screen_name
• 类型：read，幂等：是
• 状态：✅ 已验收（2026-09-16）
• 成功判据：响应 unavailable=false 且 user.user_id 非空；账号冻结/不存在时 unavailable=true（不是失败）。
• 说明：按 @handle 查用户资料（GraphQL UserByScreenName）。Web 的资料字段在 core/profile_bio/relationship_counts 等子对象里，与 Android 的 legacy 扁平块不同。 2026-09-16 真机验收：读自己的资料，rest_id 与 cookie 的 twid 一致（正面确认）。

请求 WebUserByScreenNameRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
screen_name (#2)	string	-	-

响应 WebUserResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
user (#2)	User（见消息定义）	-	-
unavailable (#3)	bool	-	unavailable 表示账号冻结 / 不存在：UserByScreenName 为 __typename 不是 "User"（此时 user 仅有 screen_name）； UserByRestID 为响应缺 rest_id 或无 data（此时 user 仅有 user_id）。
typename (#4)	string	-	typename 是上游原样返回的 __typename，便于排查 unavailable 的具体形态。
rate_limit (#5)	RateLimit（见消息定义）	-	-

消息定义

Account

proto 全名：twitter.android.v1.Account

字段	类型	约束	说明
username (#1)	string	-	-
password (#2)	string	-	plaintext — server-side only, never logged
totp_seed (#3)	string	-	plaintext 2FA secret; optional

AddSharingRequest

proto 全名：twitter.android.v1.AddSharingRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
audio_space_id (#2)	string	-	-
sharing_json (#3)	string	-	sharing 的 GraphQL 变量 JSON（透传）

AdsBudgetsRequest

proto 全名：twitter.android.v1.AdsBudgetsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
country_code (#2)	string	-	-

AdsLocationRequest

proto 全名：twitter.android.v1.AdsLocationRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
ads_account_id (#2)	string	-	-
country_code (#3)	string	-	-
language_code (#4)	string	-	-

AdsStatsRequest

proto 全名：twitter.android.v1.AdsStatsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
start_timestamp_msec (#2)	int64	-	-
end_timestamp_msec (#3)	int64	-	-

AndroidAccountState

AndroidAccountState 是 android 命名空间下完整往返的身份。 镜像 identity.AndroidAccountState（OAuth 1.0a 会话）。

proto 全名：twitter.android.v1.AndroidAccountState

字段	类型	约束	说明
account (#1)	Account（见消息定义）	-	-
device (#2)	AndroidDevice（见消息定义）	-	-
app_version (#3)	string	-	-
proxy (#4)	ProxyConfig（见消息定义）	-	proxy 与 LoginRequest.proxy 同义；不传即直连。
session (#5)	AndroidSession（见消息定义）	-	-
telemetry (#6)	AndroidTelemetry（见消息定义）	-	-

AndroidDevice

proto 全名：twitter.android.v1.AndroidDevice

字段	类型	约束	说明
client_uuid (#1)	string	-	-
device_id (#2)	string	-	-
ad_id (#3)	string	-	-
model (#4)	string	-	-
manufacturer (#5)	string	-	-
brand (#6)	string	-	-
board (#7)	string	-	-
os_version (#8)	string	-	-
build_year (#9)	string	-	-
language (#10)	string	-	-
timezone (#11)	string	-	-
sec_patch (#12)	string	-	-
limit_ad_tracking (#13)	string	-	-
attest_token (#14)	string	-	-
castle_device_id (#15)	string	-	Highwind（castle_token）的 device_id，32 位 hex。与其余安装 id 一样随设备 持久化：真机不会换，每次登录重掷会让同一账号每次都像一台新手机。

AndroidFailureContext

AndroidFailureContext 是 Android 上游失败时附加的第二个标准 status detail。 state 让调用方在失败后保住设备、会话和遥测进度；login_steps 仅 Login 使用。 此消息含敏感状态，不得复制进 status message、FailureDetail 或日志。

proto 全名：twitter.android.v1.AndroidFailureContext

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
login_steps (#2)	LoginStep（见消息定义）	repeated	-

AndroidSession

proto 全名：twitter.android.v1.AndroidSession

字段	类型	约束	说明
oauth_token (#1)	string	-	-
oauth_secret (#2)	string	-	plaintext — server-side only, never logged
cookies (#3)	string	repeated	-
user_id (#4)	string	-	-
screen_name (#5)	string	-	-

AndroidTelemetry

AndroidTelemetry 携带 jot(/1.1/jot/client_event) 的会话状态，随 AccountState 往返。 非敏感（session_id 是随机 UUID，seq 是计数器）；真机 seq 跨事件递增， 每次从 1 开始是可检测破绽，故必须持久化跨 RPC。首次登录/冷启动时由服务端铸新。

proto 全名：twitter.android.v1.AndroidTelemetry

字段	类型	约束	说明
session_id (#1)	string	-	本次 app 会话的随机 UUID
seq (#2)	int32	-	client_event_sequence_number，跨 RPC 递增
seq_start_ms (#3)	int64	-	client_event_sequence_start_timestamp（会话首事件毫秒）

AudioSpacesSearchRequest

proto 全名：twitter.android.v1.AudioSpacesSearchRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
query (#2)	string	-	-
filter (#3)	string	-	-
num_results (#4)	int32	-	-

BiometricFinishRequest

proto 全名：twitter.android.v1.BiometricFinishRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
nonce (#2)	string	-	-
face_id_passed (#3)	bool	-	-

BookmarkAckResponse

BookmarkAckResponse 只往返刷新后的 state（ack 型 mutation）。

proto 全名：twitter.android.v1.BookmarkAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

BookmarkCollectionNameRequest

proto 全名：twitter.android.v1.BookmarkCollectionNameRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
name (#2)	string	-	-

BookmarkCollectionRequest

proto 全名：twitter.android.v1.BookmarkCollectionRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
collection_id (#2)	string	-	-

BookmarkCollectionTweetRequest

proto 全名：twitter.android.v1.BookmarkCollectionTweetRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
collection_id (#2)	string	-	-
tweet_id (#3)	string	-	-

BookmarkCollectionUpdateRequest

proto 全名：twitter.android.v1.BookmarkCollectionUpdateRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
collection_id (#2)	string	-	-
name (#3)	string	-	-

BookmarkListRequest

BookmarkListRequest 无额外入参（我的书签列表 / 收藏夹列表）。

proto 全名：twitter.android.v1.BookmarkListRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

BookmarkRawResponse

BookmarkRawResponse 往返 state + 未经处理的 GraphQL data。

proto 全名：twitter.android.v1.BookmarkRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

BookmarkSearchRequest

proto 全名：twitter.android.v1.BookmarkSearchRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
query (#2)	string	-	-

BookmarkTweetRequest

proto 全名：twitter.android.v1.BookmarkTweetRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

ChainStep

ChainStep 是行为链里的一步。name 取上游 operation / 端点名的固定词表值 （如 "USER_TWEETS_AND_REPLIES"、"FOLLOW_USER_MUTATION"），便于与抓包逐步对照，绝不是 URL。

proto 全名：twitter.common.v1.ChainStep

字段	类型	约束	说明
name (#1)	string	-	-
status (#2)	ChainStepStatus	-	-
rate_limit (#3)	RateLimit（见消息定义）	-	-
failure (#4)	FailureDetail（见消息定义）	-	failure 仅在 status 为 FAILED / UNKNOWN 时设置，与单端点 RPC 的 gRPC status detail 同构。

CommunityAckResponse

proto 全名：twitter.android.v1.CommunityAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

CommunityEmptyRequest

proto 全名：twitter.android.v1.CommunityEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

CommunityIdRequest

proto 全名：twitter.android.v1.CommunityIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
community_id (#2)	string	-	-

CommunityJoinedRequest

proto 全名：twitter.android.v1.CommunityJoinedRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-
count (#3)	int32	-	-

CommunityPassthroughRequest

proto 全名：twitter.android.v1.CommunityPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

CommunityPopularRequest

proto 全名：twitter.android.v1.CommunityPopularRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
topic_id (#2)	string	-	-
count (#3)	int32	-	-

CommunityRawResponse

proto 全名：twitter.android.v1.CommunityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

CommunityRestIdRequest

proto 全名：twitter.android.v1.CommunityRestIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

CommunitySearchRequest

proto 全名：twitter.android.v1.CommunitySearchRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
query (#2)	string	-	-

CommunityTopicRequest

proto 全名：twitter.android.v1.CommunityTopicRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
topic_id (#2)	string	-	-

ConnectionPageByNameRequest

proto 全名：twitter.android.v1.ConnectionPageByNameRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
screen_name (#2)	string	-	-
initial_page (#3)	string	-	-

ConnectionPageRequest

proto 全名：twitter.android.v1.ConnectionPageRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-
initial_page (#3)	string	-	-

ContentAckResponse

proto 全名：twitter.android.v1.ContentAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

ContentDisclosureRequest

proto 全名：twitter.android.v1.ContentDisclosureRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-
advertising_disclosure (#3)	bool	-	-
ai_generated_disclosure (#4)	bool	-	-

ContentEmptyRequest

proto 全名：twitter.android.v1.ContentEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

ContentPassthroughRequest

proto 全名：twitter.android.v1.ContentPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

ContentRawResponse

proto 全名：twitter.android.v1.ContentRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ConversationControlSettingsRequest

ConversationControlSettings 无 tweet_id —— 读的是本账号的会话控制设置。

proto 全名：twitter.android.v1.ConversationControlSettingsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

CreatePollCardRequest

CreatePollCardRequest 建投票卡。发帖需两步：本 RPC 拿 card_uri → CreatePost(card_uri=…)。

proto 全名：twitter.android.v1.CreatePollCardRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
choices (#2)	string	repeated	choices 是 2–4 个纯文本选项，顺序即展示顺序。
duration_minutes (#3)	int32	-	duration_minutes 投票时长；0 = 客户端默认 1440（1 天）。合法区间 [5, 10080]。

CreatePollCardResponse

proto 全名：twitter.android.v1.CreatePollCardResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
card_uri (#2)	string	-	形如 card://123…，填进 CreatePostRequest.card_uri

CreatePostRequest

proto 全名：twitter.android.v1.CreatePostRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
text (#2)	string	-	-
media_ids (#3)	string	repeated	-
card_uri (#4)	string	optional	形状安全的可选发帖字段（基元标量，抓包 item 304 里以显式 null 出现）。 proto3 optional = 不传则 wire 保持 null（与已验收纯文字路径字节一致）。 其余作曲字段（conversation_control/geo/exclusive/tagged_users…）为嵌套形状， 未在真机流量核实，先不暴露，见 docs/development/createpost-field-capture-checklist.md。 挂已有卡片（如 poll card 的 card://…）；不传=不挂
broadcast_to_followers (#5)	bool	optional	广播给粉丝；不传=沿用上游默认
previous_tweet_id (#6)	string	optional	previous_tweet_id：把本次发布作为对该 tweet 的编辑（edit_options.previous_tweet_id， jadx JsonEditOptionsInput 唯一字段）。不传=普通新帖（edit_options 保持 {}，字节不变）。 编辑=用新的 text/media_ids 覆盖旧帖，须在编辑窗口内且为本账号原帖。仅 CreatePost 生效。
geo (#7)	PostGeo（见消息定义）	-	嵌套作曲字段（形状由 jadx 静态解出，见上方消息定义）。不设置即保持 wire null。 地点
semantic_core_ids (#8)	PostAnnotation（见消息定义）	repeated	话题/兴趣标注
conversation_control (#9)	PostConversationControl（见消息定义）	-	谁可以回复

CreatePostResponse

proto 全名：twitter.android.v1.CreatePostResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
tweet (#2)	Tweet（见消息定义）	-	-

DeletePostRequest

proto 全名：twitter.android.v1.DeletePostRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

DeletePostResponse

proto 全名：twitter.android.v1.DeletePostResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	raw_json 是未经处理的 DeleteTweet data 节点。 「删掉了」与「这条帖子本来就不存在 / 不属于本账号」目前都表现为静默成功。 区分二者的响应形状尚未在真实流量上采集，所以这里先原样带回而不是猜一个 结构化结论（charter interview #8：关键字段 + 保留 raw）。 TODO(协议核对): 置信度=未确认; 真机采集后在此基础上增加 deleted / not_found， raw_json 保留作兜底。

DeleteSharingRequest

proto 全名：twitter.android.v1.DeleteSharingRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
audio_space_id (#2)	string	-	-
sharing_id (#3)	string	-	-

DmEmptyRequest

proto 全名：twitter.android.v1.DmEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

DmRawResponse

proto 全名：twitter.android.v1.DmRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

DmRequest

DmRequest 携带 variables_json（结构化入参透传）。

proto 全名：twitter.android.v1.DmRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

EmailSettingsUpdateRequest

proto 全名：twitter.android.v1.EmailSettingsUpdateRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-
settings_json (#3)	string	-	settings 的 GraphQL 变量 JSON（透传）

EngageRequest

EngageRequest 是 like/unlike/retweet/unretweet 的共享入参。 对 Unretweet 而言，tweet_id 是原始（源）推文 id。

proto 全名：twitter.android.v1.EngageRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

EngageResponse

proto 全名：twitter.android.v1.EngageResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)

FaceLivenessResultsRequest

proto 全名：twitter.android.v1.FaceLivenessResultsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
session_id (#2)	string	-	-

FailureDetail

FailureDetail 是所有上游失败的标准 gRPC status detail。 operation 来自固定词表；底层错误文本不得进入本消息。

proto 全名：twitter.common.v1.FailureDetail

字段	类型	约束	说明
kind (#1)	FailureKind	-	-
operation (#2)	string	-	-
retry_advice (#3)	RetryAdvice	-	-
upstream_http_status (#4)	int32	optional	-
transport (#5)	TransportFailure（见消息定义）	-	-
reason (#6)	FailureReason	-	以下为诊断字段（2026-09-07 起）：只解释「为什么是这个 kind」，不改变处置语义。
upstream_error_codes (#7)	int32	repeated	上游 errors[].code 数字（REST / GraphQL 同一套码表）；空 = 正文里没有。
upstream_error_message (#8)	string	-	★仅展示★：来自解析后的 errors[].message 或 JF errors 字段（折叠空白、按 200 字符截断）， 绝不是响应正文片段；不含 token / cookie / 账号资料。文案随语言与版本变化，禁止据此做程序分支。
next_component (#9)	string	-	登录：X 的 UI 路由名（login_enter_password / totp / login_success …），不含账号信息。
jf_component (#10)	string	-	登录：JF 页 component 字段（如 "errors"）。
failure_id (#11)	string	-	随机短 id（16 位 hex）；服务端日志同一条失败带 failure_id=<值>，拿它找运维即可定位上游原文。

FeedbackReportRequest

proto 全名：twitter.android.v1.FeedbackReportRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
title (#2)	string	-	-
values_json (#3)	string	-	values 的 GraphQL 变量 JSON（结构化，由调用方按上游 schema 提供；形状未真机核对）。

FinanceAssetRequest

proto 全名：twitter.android.v1.FinanceAssetRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
asset_symbol (#2)	string	-	-
currency_code (#3)	string	-	-

FinanceChartRequest

proto 全名：twitter.android.v1.FinanceChartRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
asset_symbol (#2)	string	-	-
timeframe (#3)	string	-	-
candle_size (#4)	string	-	-
currency_code (#5)	string	-	-

FinanceSearchRequest

proto 全名：twitter.android.v1.FinanceSearchRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
query (#2)	string	-	-
currency_code (#3)	string	-	-
page_size (#4)	int32	-	-

FriendsFollowingTimelineRequest

proto 全名：twitter.android.v1.FriendsFollowingTimelineRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-
count (#3)	int32	optional	请求返回多少条。不传则用客户端自身的默认值（3）—— 用 optional，使「未设置」能与显式的 0 区分开（宪章 §2）。

GifCategoryRequest

proto 全名：twitter.android.v1.GifCategoryRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
category (#2)	string	-	-
image_format (#3)	string	-	-

GifSearchRequest

proto 全名：twitter.android.v1.GifSearchRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
query (#2)	string	-	-
image_format (#3)	string	-	-

GrokHistoryRequest

proto 全名：twitter.android.v1.GrokHistoryRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
cursor (#2)	string	-	-

GrokMemoryRequest

proto 全名：twitter.android.v1.GrokMemoryRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
allow (#2)	bool	-	-

GrokPreferencesRequest

proto 全名：twitter.android.v1.GrokPreferencesRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
grok_mode (#2)	string	-	-
grok_model_id (#3)	string	-	-

HideVerificationRequest

proto 全名：twitter.android.v1.HideVerificationRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-
hidden (#3)	bool	-	-

HomeTimelineRequest

proto 全名：twitter.android.v1.HomeTimelineRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

IdentityVerificationRequest

proto 全名：twitter.android.v1.IdentityVerificationRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
verification_flow (#2)	string	-	-
success_url (#3)	string	-	-
error_url (#4)	string	-	-

InferredLocationRequest

proto 全名：twitter.android.v1.InferredLocationRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
preference (#2)	string	-	枚举字符串

InstalledAppsRequest

proto 全名：twitter.android.v1.InstalledAppsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
slugs_json (#2)	string	-	slugs 的 GraphQL 变量 JSON（透传）

JobSearchRequest

proto 全名：twitter.android.v1.JobSearchRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
search_params_json (#2)	string	-	searchParams 的 GraphQL 变量 JSON（透传）

JobsCompanyRequest

proto 全名：twitter.android.v1.JobsCompanyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
screen_name (#2)	string	-	-

ListAckResponse

proto 全名：twitter.android.v1.ListAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

ListBannerRequest

proto 全名：twitter.android.v1.ListBannerRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
list_id (#2)	string	-	-
media_id (#3)	string	-	-

ListCreateRequest

proto 全名：twitter.android.v1.ListCreateRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
name (#2)	string	-	-
is_private (#3)	bool	-	-
description (#4)	string	-	-

ListEmptyRequest

proto 全名：twitter.android.v1.ListEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

ListIdRequest

proto 全名：twitter.android.v1.ListIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
list_id (#2)	string	-	-

ListMemberRequest

proto 全名：twitter.android.v1.ListMemberRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
list_id (#2)	string	-	-
user_id (#3)	string	-	-

ListRawResponse

proto 全名：twitter.android.v1.ListRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ListRestIdRequest

proto 全名：twitter.android.v1.ListRestIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

ListUpdateRequest

proto 全名：twitter.android.v1.ListUpdateRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
list_id (#2)	string	-	-
is_private (#3)	bool	-	-
new_name (#4)	string	-	-
new_description (#5)	string	-	-

ListUserRequest

proto 全名：twitter.android.v1.ListUserRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-

LoginRequest

proto 全名：twitter.android.v1.LoginRequest

字段	类型	约束	说明
username (#1)	string	-	-
password (#2)	string	-	-
totp (#3)	string	-	totp 是当前的 2FA 验证码；账号没有 2FA 时为空。 优先用 totp_seed：调用方算出的码可能在传输途中就过期。
version (#4)	string	optional	version 选择客户端 build（默认最新）；可选。
proxy (#5)	ProxyConfig（见消息定义）	-	proxy 只表示 SOCKS5H；目标域名固定由代理解析，避免服务端 DNS 泄漏。 不传即直连。用户名与密码必须同时设置或同时省略。
attest_account_id (#6)	string	optional	attest_account_id 在 guest 阶段绑定 attestation；可选。
totp_seed (#7)	string	optional	totp_seed 是 base32 的 2FA 密钥。服务端在真正执行 2FA 步骤那一刻才算码， 从而消除调用方自算 totp 带来的「请求还没到码就过期了」竞态。 设置了 totp 时忽略本字段。明文 —— 仅服务端使用，绝不写日志。

LoginResponse

proto 全名：twitter.android.v1.LoginResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

LoginStep

LoginStep 是登录状态机的一个边界点。登录是跨端点的流程， 所以光说「它失败了」没法据以行动 —— step 让人不看服务端日志也能定位它。

proto 全名：twitter.common.v1.LoginStep

字段	类型	约束	说明
name (#1)	string	-	name 是固定标签（如 "guest activate"），绝不是 URL： JF 的 path 在 query 串里带着 session_token / user_id。
ok (#2)	bool	-	-
failure_kind (#3)	FailureKind	-	failure_kind / failure_summary 仅在 ok 为 false 时设置。
failure_summary (#4)	string	-	failure_summary 是由 failure_kind 选出的固定文案 —— 绝不从上游错误派生， 后者可能持有含 token 或 cookie 的响应体。
http_status (#5)	int32	-	http_status 是有上游状态码时的值；否则为 0。

MeRequest

proto 全名：twitter.android.v1.MeRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

MediaBoolRequest

proto 全名：twitter.android.v1.MediaBoolRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
allow (#2)	bool	-	-

MediaCursorRequest

proto 全名：twitter.android.v1.MediaCursorRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
cursor (#2)	string	-	-

MediaRawResponse

proto 全名：twitter.android.v1.MediaRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

MediaRestIdRequest

proto 全名：twitter.android.v1.MediaRestIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

MediaUrlRequest

proto 全名：twitter.android.v1.MediaUrlRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
url (#2)	string	-	-

MediaViewRequest

proto 全名：twitter.android.v1.MediaViewRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
view (#2)	string	-	-

ModerationAckResponse

proto 全名：twitter.android.v1.ModerationAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

ModerationEmptyRequest

proto 全名：twitter.android.v1.ModerationEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

ModerationRawResponse

proto 全名：twitter.android.v1.ModerationRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ModerationRestIdRequest

proto 全名：twitter.android.v1.ModerationRestIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

ModerationTweetRequest

proto 全名：twitter.android.v1.ModerationTweetRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

MoneyRawResponse

proto 全名：twitter.android.v1.MoneyRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

MoneyRequest

proto 全名：twitter.android.v1.MoneyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

PalmFinishRequest

proto 全名：twitter.android.v1.PalmFinishRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
nonce (#2)	string	-	-
palm_passed (#3)	bool	-	-
token (#4)	string	-	-

PalmTokenRequest

proto 全名：twitter.android.v1.PalmTokenRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
token (#2)	string	-	-

PostAnnotation

PostAnnotation 一条话题/兴趣标注（semantic_core_ids 的元素）。三个 id 均为数字。 PostAnnotation 一条话题/兴趣标注（semantic_core_ids 的元素）。 ★三个 id 是字符串★（真机取证：Apollo 按 GraphQL ID 标量序列化为 string， 与 jadx LoganSquare mapper 的 long 不同——以真机为准）。 发社区帖即用本消息：domain_id="31"、entity_id=、group_id="8"。

proto 全名：twitter.android.v1.PostAnnotation

字段	类型	约束	说明
domain_id (#1)	string	-	-
entity_id (#2)	string	-	-
group_id (#3)	string	-	-

PostByIdRequest

PostByIdRequest 是帖子读扩展（单帖/翻译/转发者/编辑历史/是否精选）的共享入参。 tweet_id 是目标帖子 id；上游各端点的变量名（rest_id / tweet_id / postId）由服务端映射。

proto 全名：twitter.android.v1.PostByIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-

PostConversationControl

PostConversationControl 限制谁可以回复本帖。 mode 取值（★Pascal 枚举名，非小写★）：ByInvitation / Community / Subscribers / Verified / MyNetwork / CountryOfOrigin / Premium。 allowed_country_codes 只在 mode=CountryOfOrigin 时有意义。 不设置本消息 = 所有人可回复（客户端在该情况下根本不下发 conversation_control）。

proto 全名：twitter.android.v1.PostConversationControl

字段	类型	约束	说明
mode (#1)	string	-	-
allowed_country_codes (#2)	string	repeated	-

PostDraftIdRequest

proto 全名：twitter.android.v1.PostDraftIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
post_id (#2)	string	-	-

PostEmptyRequest

PostEmptyRequest 是帖子域内无额外入参的只读查询（草稿/可编辑/恶搞/置顶时间线）入参。

proto 全名：twitter.android.v1.PostEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

PostGeo

PostGeo 发帖地点。三个字段都可选：只填 place_id 是最常见用法。

proto 全名：twitter.android.v1.PostGeo

字段	类型	约束	说明
place_id (#1)	string	-	-
coordinates (#2)	PostGeoCoordinates（见消息定义）	-	-
geo_search_request_id (#3)	string	-	-

PostGeoCoordinates

PostGeoCoordinates 精确坐标。display_coordinates=false 表示带位置但不公开精确坐标 （客户端在无定位权限时正是这么发的）。三个字段恒下发。

proto 全名：twitter.android.v1.PostGeoCoordinates

字段	类型	约束	说明
display_coordinates (#1)	bool	-	-
latitude (#2)	double	-	-
longitude (#3)	double	-	-

PostLabelRequest

proto 全名：twitter.android.v1.PostLabelRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
label (#2)	string	-	-

PostLanguageRequest

proto 全名：twitter.android.v1.PostLanguageRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
language (#2)	string	-	-

PostLanguageToggleRequest

proto 全名：twitter.android.v1.PostLanguageToggleRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
language (#2)	string	-	-
enable (#3)	bool	-	-

PostPassthroughRequest

PostPassthroughRequest 用于结构化入参的帖子写：调用方传完整 GraphQL variables JSON。

proto 全名：twitter.android.v1.PostPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

PostReadResponse

PostReadResponse 往返 state + 未经处理的 GraphQL data（raw 兜底）。

proto 全名：twitter.android.v1.PostReadResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

PostTargetRequest

PostTargetRequest 是帖子域内以 target_user_id 为目标的操作（独家帖/转发/回复设备关注）入参。

proto 全名：twitter.android.v1.PostTargetRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
target_user_id (#2)	string	-	-

ProfileAnalyticsRequest

proto 全名：twitter.android.v1.ProfileAnalyticsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-
from_time (#3)	string	-	RFC3339 Z
to_time (#4)	string	-	-

ProfileModulesRequest

proto 全名：twitter.android.v1.ProfileModulesRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

ProxyConfig

ProxyConfig 是唯一公开代理类型，目前只接受 SOCKS5H（域名由代理解析，禁止本地 DNS 泄漏）。 host 不带 scheme/端口；port 必须在 1..65535。

proto 全名：twitter.common.v1.ProxyConfig

字段	类型	约束	说明
protocol (#1)	ProxyProtocol	-	-
host (#2)	string	-	-
port (#3)	uint32	-	-
credentials (#4)	ProxyCredentials（见消息定义）	-	-

ProxyCredentials

ProxyCredentials 是 SOCKS5H 可选认证。只允许完整的用户名 + 密码组合。

proto 全名：twitter.common.v1.ProxyCredentials

字段	类型	约束	说明
username (#1)	string	-	-
password (#2)	string	-	-

QuickPromoteLocationRequest

proto 全名：twitter.android.v1.QuickPromoteLocationRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
ads_account_id (#2)	string	-	-
query (#3)	string	-	-
language_code (#4)	string	-	-

QuoteRequest

proto 全名：twitter.android.v1.QuoteRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
quoted_tweet_id (#2)	string	-	-
text (#3)	string	-	-
media_ids (#4)	string	repeated	-
card_uri (#5)	string	optional	-
broadcast_to_followers (#6)	bool	optional	-
quoted_screen_name (#7)	string	-	★必填★ 被引用推文作者的 screen_name（不带 @）。 真机实测上游只接受 https://twitter.com/{screen_name}/status/{id} 这种带作者的 永久链接；匿名的 /i/web/status/{id} 会被拒为 attachment_url parameter is invalid. (44)，所以光有 tweet_id 拼不出合法链接。
geo (#8)	PostGeo（见消息定义）	-	-
semantic_core_ids (#9)	PostAnnotation（见消息定义）	repeated	-
conversation_control (#10)	PostConversationControl（见消息定义）	-	-

RateLimit

RateLimit 是上游 x-rate-limit-* 响应头的原样回传，供调用方自己排期。 ★SDK 不会等待重置★（宪章 §2 例外 2：限流等待属调用方编排）。

proto 全名：twitter.common.v1.RateLimit

字段	类型	约束	说明
limit (#1)	int32	-	-
remaining (#2)	int32	-	-
reset_unix (#3)	int64	-	reset_unix 是配额窗口重置时间（unix 秒）；上游没给则为 0。

RawResponse

RawResponse 往返 state + 未经处理的 GraphQL data（raw 兜底）。

proto 全名：twitter.android.v1.RawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

ReplyRequest

proto 全名：twitter.android.v1.ReplyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
in_reply_to_tweet_id (#2)	string	-	-
text (#3)	string	-	-
media_ids (#4)	string	repeated	-
card_uri (#5)	string	optional	与 CreatePostRequest 同名字段语义一致 —— 三个入口发的是同一个 CreatePost operation，可写字段必须对齐，不允许只给其中一个开口子。
broadcast_to_followers (#6)	bool	optional	-
exclude_reply_user_ids (#7)	string	repeated	exclude_reply_user_ids：回复时不提及的 user_id；留空 = 提及全部（wire 为 []）。
geo (#8)	PostGeo（见消息定义）	-	-
semantic_core_ids (#9)	PostAnnotation（见消息定义）	repeated	-
conversation_control (#10)	PostConversationControl（见消息定义）	-	-

SearchPlaceNameRequest

proto 全名：twitter.android.v1.SearchPlaceNameRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
place_name (#2)	string	-	-
latitude (#3)	double	-	-
longitude (#4)	double	-	-
max_places (#5)	int32	-	-

SearchQueryRequest

proto 全名：twitter.android.v1.SearchQueryRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
query (#2)	string	-	-

SearchRawResponse

proto 全名：twitter.android.v1.SearchRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

SearchTypeaheadRequest

proto 全名：twitter.android.v1.SearchTypeaheadRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
query (#2)	string	-	-
max_count (#3)	int32	-	-

SecurityAckResponse

proto 全名：twitter.android.v1.SecurityAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

SecurityEmptyRequest

proto 全名：twitter.android.v1.SecurityEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

SecurityPassthroughRequest

proto 全名：twitter.android.v1.SecurityPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	结构化入参的 GraphQL 变量 JSON（透传）

SecurityRawResponse

proto 全名：twitter.android.v1.SecurityRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

SecurityRestIdRequest

proto 全名：twitter.android.v1.SecurityRestIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

SelfCustodyUploadRequest

proto 全名：twitter.android.v1.SelfCustodyUploadRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
ciphertext_base64 (#2)	string	-	-

SelfieRequest

proto 全名：twitter.android.v1.SelfieRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
image_id (#2)	string	-	-

SelfieStatusRequest

proto 全名：twitter.android.v1.SelfieStatusRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
transaction_id (#2)	string	-	-

SetMediaMetadataRequest

proto 全名：twitter.android.v1.SetMediaMetadataRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
media_id (#2)	string	-	-
alt_text (#3)	string	-	无障碍描述文本

SetMediaMetadataResponse

proto 全名：twitter.android.v1.SetMediaMetadataResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

SettingsAckResponse

proto 全名：twitter.android.v1.SettingsAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

SettingsEmptyRequest

proto 全名：twitter.android.v1.SettingsEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

SettingsPassthroughRequest

SettingsPassthroughRequest 用于结构化偏好更新：调用方传完整 GraphQL variables JSON。 形状未真机核对，故透传而不在 SDK 臆造（宪章）。

proto 全名：twitter.android.v1.SettingsPassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

SettingsRawResponse

proto 全名：twitter.android.v1.SettingsRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

SocialRequest

SocialRequest 是所有关系操作的共享入参：state + 目标用户 rest_id。 user_id 是被操作的目标用户；上游 GraphQL 变量名（target_user_id vs user_id） 的差异由服务端按端点映射，调用方一律传 user_id。

proto 全名：twitter.android.v1.SocialRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
user_id (#2)	string	-	-

SocialResponse

SocialResponse 只往返刷新后的 state —— 这些端点是 ack 型 mutation， 无有用的结构化返回数据（宪章 §3）。

proto 全名：twitter.android.v1.SocialResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

SpaceIdRequest

proto 全名：twitter.android.v1.SpaceIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
audio_space_id (#2)	string	-	-

SpaceRestIdRequest

proto 全名：twitter.android.v1.SpaceRestIdRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

SpaceTopicsRequest

proto 全名：twitter.android.v1.SpaceTopicsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
seed_category_id (#2)	string	-	-

SpacesAckResponse

proto 全名：twitter.android.v1.SpacesAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

SpacesEmptyRequest

proto 全名：twitter.android.v1.SpacesEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

SpacesRawResponse

proto 全名：twitter.android.v1.SpacesRawResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json (#2)	string	-	-

TelemetryLogRequest

proto 全名：twitter.android.v1.TelemetryLogRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
raw_json_string (#2)	string	-	-

TimelinePassthroughRequest

TimelinePassthroughRequest 携带 variables_json（结构化入参透传，不臆造形状）。

proto 全名：twitter.android.v1.TimelinePassthroughRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
variables_json (#2)	string	-	-

TimelineResponse

proto 全名：twitter.android.v1.TimelineResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
raw_json (#2)	string	-	untouched GraphQL timeline payload

TopicPageRequest

proto 全名：twitter.android.v1.TopicPageRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

TopicTrendRequest

proto 全名：twitter.android.v1.TopicTrendRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
trend_id (#2)	string	-	-

TransportFailure

TransportFailure 是 FailureDetail 的可选网络诊断。只有 transport 提供了 结构化证据时才设置；裸 error 不得通过文本匹配伪造这些字段。

proto 全名：twitter.common.v1.TransportFailure

字段	类型	约束	说明
phase (#1)	TransportPhase	-	-
cause (#2)	TransportCause	-	-
delivery_state (#3)	RequestDeliveryState	-	-
attempts (#4)	uint32	-	attempts 是包含首次请求在内、由本项目 retry policy 发起的应用层尝试次数。 HTTP/2 对 GOAWAY / REFUSED_STREAM 等“服务器已明确未处理”的协议级安全重建不计入本字段。
via_proxy (#5)	bool	-	-

Tweet

Tweet 是一条已发布/读取的推文。结构化关键字段 + raw_json 兜底 （宪章访谈 #8：关键字段 + 保留 raw）—— GraphQL schema 漂移时，改为解析 raw_json， 而不是改这个 message。CreatePost 只填 tweet_id；读接口（B3）填其余字段。

proto 全名：twitter.common.v1.Tweet

字段	类型	约束	说明
tweet_id (#1)	string	-	rest_id（推文数字 id）
text (#2)	string	-	-
user_id (#3)	string	-	作者 rest_id
screen_name (#4)	string	-	-
created_at (#5)	int64	-	unix 秒；未知为 0
favorite_count (#6)	int64	-	-
retweet_count (#7)	int64	-	-
reply_count (#8)	int64	-	-
quote_count (#9)	int64	-	-
view_count (#10)	int64	-	-
raw_json (#15)	string	-	raw_json 是未经处理的 GraphQL tweet_results 载荷（漂移兜底）。

UploadMediaRequest

proto 全名：twitter.android.v1.UploadMediaRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
data (#2)	bytes	-	原始图片字节
mime_type (#3)	string	-	默认 image/jpeg
media_category (#4)	string	-	默认 tweet_image

UploadMediaResponse

proto 全名：twitter.android.v1.UploadMediaResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	刷新后的往返状态（宪章 §3）
media_id (#2)	string	-	-

UploadVideoRequest

proto 全名：twitter.android.v1.UploadVideoRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
data (#2)	bytes	-	原始视频字节
mime_type (#3)	string	-	默认 video/mp4
media_category (#4)	string	-	默认 tweet_video（也可 amplify_video）

UrtFeedbackRequest

proto 全名：twitter.android.v1.UrtFeedbackRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
encoded_feedback_request (#2)	string	-	上游给的不透明串
is_undo (#3)	bool	-	-

User

User 是一份读取到的资料（B3）。结构化关键字段 + raw_json 兜底。 字段 9-14 是账号巡检类字段，来自真机采集到的 legacy 块实际内容（2026-08-13）， 不是按需求推断的。 ★关于账号所在地（account_based_in）★：UserResultByIdQuery（即本 message 的来源端点） 的 legacy 块不返回该字段。但静态分析显示另一个端点 AboutProfileQuery 提供 account_based_in / created_country / username_changes 等字段 —— 尚未真机验证，验证通过后会作为独立 RPC 补上。不要据「本端点没有」推断「协议没有」。

proto 全名：twitter.common.v1.User

字段	类型	约束	说明
user_id (#1)	string	-	rest_id（用户数字 id）
screen_name (#2)	string	-	-
name (#3)	string	-	-
description (#4)	string	-	-
followers_count (#5)	int64	-	-
following_count (#6)	int64	-	-
tweet_count (#7)	int64	-	-
verified (#8)	bool	-	-
location (#9)	string	-	location 是用户自填的地区文本，可为空、可任意填写，不是平台判定的所在地。
created_at (#10)	int64	-	created_at 是账号注册时间，unix 秒；无法解析时为 0（原始字符串仍在 raw_json）。 上游给的是 "Wed Aug 27 13:08:45 +0000 2008" 这种格式，这里统一转成时间戳， 与 Tweet.created_at 保持一致，方便直接落库比较。
protected (#11)	bool	-	protected 表示账号已设为私密。
profile_image_url (#12)	string	-	profile_image_url 是头像地址（https）。
suspended (#13)	bool	-	suspended 表示账号被平台封禁。★这是巡检信号，不是失败分类★：它来自读取到的 资料，与 FailureKind 的 BANNED 是两条独立证据链，不要互相推断。
needs_phone_verification (#14)	bool	-	needs_phone_verification 表示账号被要求手机验证。命名跟随上游字段本名—— 它只覆盖手机验证这一种，不代表全部「待验证」状态。
raw_json (#15)	string	-	raw_json 是未经处理的 GraphQL user_result 载荷（漂移兜底）。

UserAckResponse

proto 全名：twitter.android.v1.UserAckResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

UserBoolRequest

proto 全名：twitter.android.v1.UserBoolRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
allow (#2)	bool	-	-

UserByRestIDRequest

proto 全名：twitter.android.v1.UserByRestIDRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

UserByScreenNameRequest

proto 全名：twitter.android.v1.UserByScreenNameRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
screen_name (#2)	string	-	不带 @ 的用户名

UserEmptyRequest

proto 全名：twitter.android.v1.UserEmptyRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

UserHighlightsRequest

proto 全名：twitter.android.v1.UserHighlightsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

UserResponse

proto 全名：twitter.android.v1.UserResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	refreshed round-trip state (charter §3)
user (#2)	User（见消息定义）	-	-

UserTweetsRequest

proto 全名：twitter.android.v1.UserTweetsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_id (#2)	string	-	-

UsernameRequest

proto 全名：twitter.android.v1.UsernameRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
username (#2)	string	-	-

UsersAvatarsRequest

proto 全名：twitter.android.v1.UsersAvatarsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
ids_json (#2)	string	-	ids 的 GraphQL 变量 JSON（透传）

UsersByIdsRequest

proto 全名：twitter.android.v1.UsersByIdsRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
rest_ids (#2)	string	repeated	一批数字 user id

ViewerUserRequest

ViewerUserQuery 不接收调用方提供的字段 —— 观察者就是这个会话本身。

proto 全名：twitter.android.v1.ViewerUserRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

WebAccount

WebAccount 是 Web 会话对应的账号。user_id 取自 twid cookie； screen_name 由调用方提供，或由 AccountSettings 回填 —— 改资料类行为链要用它查自己的资料。

proto 全名：twitter.web.v1.WebAccount

字段	类型	约束	说明
user_id (#1)	string	-	-
screen_name (#2)	string	-	-

WebAccountState

WebAccountState 是 web 命名空间下完整往返的身份（宪章 §3）。 ★含明文 cookie（auth_token / ct0）★：使用方必须加密存储，日志一律脱敏。

proto 全名：twitter.web.v1.WebAccountState

字段	类型	约束	说明
account (#1)	WebAccount（见消息定义）	-	-
cookies (#2)	WebCookie（见消息定义）	repeated	cookies 至少要有 auth_token、ct0、twid，缺一律拒绝（web-integration-rules C7）。
transaction (#3)	WebTransaction（见消息定义）	-	-
proxy (#4)	ProxyConfig（见消息定义）	-	proxy 只表示 SOCKS5H；不传即从 server 本机直连。
app_version (#5)	string	-	app_version 选择 Web 客户端版本档（默认最新，目前只有 chrome144）。

WebAckResponse

proto 全名：twitter.web.v1.WebAckResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
result (#2)	string	-	result 是上游返回的字符串结果（点赞 favorite_tweet / 收藏 tweet_bookmark_put，成功为 "Done"）。
rate_limit (#3)	RateLimit（见消息定义）	-	-

WebApplyMediaRequest

proto 全名：twitter.web.v1.WebApplyMediaRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
media_id (#2)	string	-	-

WebChainFollowRequest

proto 全名：twitter.web.v1.WebChainFollowRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
user_id (#2)	string	-	user_id 是目标用户 rest_id。
force (#3)	bool	-	force 为 true 时，即使时间线显示已关注也照发关注请求。
like (#4)	bool	-	like / bookmark 是抓包里紧跟关注的附带动作开关。★由调用方决定是否执行★—— 概率（如 0.56）在调用方掷骰子，SDK 内不出现随机概率。 bookmark 只在点赞成功后才执行（与抓包一致）。
bookmark (#5)	bool	-	-

WebChainFollowResponse

proto 全名：twitter.web.v1.WebChainFollowResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
steps (#2)	ChainStep（见消息定义）	repeated	steps 按执行顺序给出：BOOTSTRAP / USER_TWEETS_AND_REPLIES / FOLLOW_USER_MUTATION / FAVORITE_TWEET / CREATE_BOOKMARK。
target_screen_name (#3)	string	-	-
already_following (#4)	bool	-	already_following 是执行关注之前时间线显示的关注状态。
follow_typename (#5)	string	-	follow_typename 是关注步的上游 __typename（成功为 "FollowSuccessResult"）；跳过时为空。
liked_tweet_id (#6)	string	-	liked_tweet_id 是 SDK 从时间线里随机挑中的推文；未点赞时为空。

WebChainMediaRequest

proto 全名：twitter.web.v1.WebChainMediaRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
image (#2)	bytes	-	-
filename (#3)	string	-	-

WebChainProfileResponse

WebChainProfileResponse 是改资料 / 换头像 / 换横幅三条链的共享出参。

proto 全名：twitter.web.v1.WebChainProfileResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
steps (#2)	ChainStep（见消息定义）	repeated	steps：BOOTSTRAP / USER_BY_SCREEN_NAME / UPLOAD_MEDIA(仅头像横幅) / UPDATE_PROFILE 等。
profile (#3)	WebProfileResponse（见消息定义）	-	profile 是动作成功时上游回显的资料；失败或未执行时为空。
media_id (#4)	string	-	media_id 是换头像/横幅链上传出的 media；改资料链为空。
account_unavailable (#5)	bool	-	account_unavailable 表示 CHECK 步判定账号不可用（__typename 不是 "User"），动作步未执行。

WebChainSettingsRequest

proto 全名：twitter.web.v1.WebChainSettingsRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
settings (#2)	WebSettingKV（见消息定义）	repeated	-

WebChainSettingsResponse

proto 全名：twitter.web.v1.WebChainSettingsResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
steps (#2)	ChainStep（见消息定义）	repeated	steps：BOOTSTRAP / USER_BY_SCREEN_NAME / ACCOUNT_SETTINGS。
settings (#3)	WebSettingsResponse（见消息定义）	-	-
account_unavailable (#4)	bool	-	-

WebChainUpdateProfileRequest

proto 全名：twitter.web.v1.WebChainUpdateProfileRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
fields (#2)	WebProfileFields（见消息定义）	-	-

WebCookie

WebCookie 是 cookie jar 里的一项。有序：按浏览器的创建顺序发送， 上游 Set-Cookie 全量回写（含删除），ct0 轮换后 x-csrf-token 自动跟着换。

proto 全名：twitter.web.v1.WebCookie

字段	类型	约束	说明
name (#1)	string	-	-
value (#2)	string	-	-

WebFollowRequest

proto 全名：twitter.web.v1.WebFollowRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
user_id (#2)	string	-	-

WebFollowResponse

proto 全名：twitter.web.v1.WebFollowResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
typename (#2)	string	-	typename 是成功判据：必须为 "FollowSuccessResult"，其它值一律视为失败。
rate_limit (#3)	RateLimit（见消息定义）	-	-

WebProfileFields

WebProfileFields 覆盖 update_profile 端点的全部可写字段（抓包表单一致）。 name 不能为空 —— 上游会回 [120] Name can't be blank。 生日三项要么同填要么同空；两个 visibility 留空时按抓包默认 "self"。

proto 全名：twitter.web.v1.WebProfileFields

字段	类型	约束	说明
name (#1)	string	-	-
description (#2)	string	-	-
location (#3)	string	-	-
url (#4)	string	-	-
birthdate_day (#5)	string	-	-
birthdate_month (#6)	string	-	-
birthdate_year (#7)	string	-	-
birthdate_visibility (#8)	string	-	-
birthdate_year_visibility (#9)	string	-	-

WebProfileResponse

proto 全名：twitter.web.v1.WebProfileResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
user_id (#2)	string	-	成功判据：上游回显的用户对象里 id_str 非空。
screen_name (#3)	string	-	-
name (#4)	string	-	-
profile_image_url (#5)	string	-	-
profile_banner_url (#6)	string	-	-
raw_json (#7)	string	-	-
rate_limit (#8)	RateLimit（见消息定义）	-	-

WebSettingKV

WebSettingKV 是一个设置项。有序：按调用方给的顺序拼进表单（抓包里 include_* 开关在前）。

proto 全名：twitter.web.v1.WebSettingKV

字段	类型	约束	说明
key (#1)	string	-	-
value (#2)	string	-	-

WebSettingsResponse

proto 全名：twitter.web.v1.WebSettingsResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
screen_name (#2)	string	-	screen_name 来自响应，用于 cookie 探活的正面确认（web-integration-rules C7）。
raw_json (#3)	string	-	raw_json 是完整设置对象（上游回显）。
rate_limit (#4)	RateLimit（见消息定义）	-	-

WebStateRequest

proto 全名：twitter.web.v1.WebStateRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-

WebTimelineResponse

proto 全名：twitter.web.v1.WebTimelineResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
tweet_ids (#2)	string	repeated	tweet_ids 是顶层 tweet-<id> 条目（与抓包工具取法一致）。
screen_name (#3)	string	-	screen_name / following 来自响应里的目标用户对象（relationship_perspectives.following）。
following (#4)	bool	-	-
next_cursor (#5)	string	-	next_cursor 是 cursor-bottom 条目的值；没有则为空。
raw_json (#6)	string	-	raw_json 是未经处理的响应（漂移兜底）。
rate_limit (#7)	RateLimit（见消息定义）	-	-

WebTransaction

WebTransaction 是 x-client-transaction-id 的派生材料（web-integration-rules C5）。 ★server-rotating，绝不硬编码★：verification_key 来自页面 HTML 的 twitter-site-verification meta，animation_key 由页面 SVG 动画帧 + ondemand 脚本里的 密钥下标合成。缺失时 SDK 自动预热（GET x.com/messages + ondemand.s.a.js）； 调用方清空本字段即可强制下次调用重新预热。

proto 全名：twitter.web.v1.WebTransaction

字段	类型	约束	说明
verification_key (#1)	string	-	-
animation_key (#2)	string	-	-
ondemand_hash (#3)	string	-	ondemand_hash 仅用于排查脚本轮换；不参与签名。
fetched_at_unix (#4)	int64	-	-

WebTweetRequest

proto 全名：twitter.web.v1.WebTweetRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
tweet_id (#2)	string	-	-
screen_name (#3)	string	-	screen_name 是推文作者的 handle，只用于装配 referer（抓包里点赞/收藏的 referer 是 https://x.com/<作者handle>）；留空则用站点根。

WebUpdateProfileRequest

proto 全名：twitter.web.v1.WebUpdateProfileRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
fields (#2)	WebProfileFields（见消息定义）	-	-

WebUpdateSettingsRequest

proto 全名：twitter.web.v1.WebUpdateSettingsRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
settings (#2)	WebSettingKV（见消息定义）	repeated	-

WebUploadMediaRequest

proto 全名：twitter.web.v1.WebUploadMediaRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
image (#2)	bytes	-	image 是原图字节，上限 5 MB（抓包一致）。
filename (#3)	string	-	filename 只用于推断 media_type（扩展名），不会发给上游。
media_category (#4)	string	-	media_category 为空 = 头像；横幅传 "banner_image"（抓包一致）。

WebUploadMediaResponse

proto 全名：twitter.web.v1.WebUploadMediaResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
media_id (#2)	string	-	-
rate_limit (#3)	RateLimit（见消息定义）	-	-

WebUserByRestIDRequest

proto 全名：twitter.web.v1.WebUserByRestIDRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
user_id (#2)	string	-	user_id 是数字 rest_id。

WebUserByScreenNameRequest

proto 全名：twitter.web.v1.WebUserByScreenNameRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
screen_name (#2)	string	-	-

WebUserListRequest

proto 全名：twitter.web.v1.WebUserListRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
user_id (#2)	string	-	user_id 必须是数字 rest_id，不接受 @handle（先用 UserByScreenName 换 id）。
count (#3)	int32	-	count 为 0 时发浏览器默认值 20。★实测上游每页回 50 条（请求 count=20，2026-09-16）★，count 只是提示值。
cursor (#4)	string	-	-

WebUserListResponse

proto 全名：twitter.web.v1.WebUserListResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
users (#2)	User（见消息定义）	repeated	users 是本页的 user-* 条目；两种结构（新扁平 / 旧 legacy）都取不到 name 与 screen_name 的条目会被丢弃。
next_cursor (#3)	string	-	next_cursor 为空表示没有下一页（上游以 0\| 开头的游标也按到底处理）。
raw_json (#4)	string	-	raw_json 是未经处理的响应（漂移兜底）。
rate_limit (#5)	RateLimit（见消息定义）	-	-

WebUserResponse

proto 全名：twitter.web.v1.WebUserResponse

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
user (#2)	User（见消息定义）	-	-
unavailable (#3)	bool	-	unavailable 表示账号冻结 / 不存在：UserByScreenName 为 __typename 不是 "User"（此时 user 仅有 screen_name）； UserByRestID 为响应缺 rest_id 或无 data（此时 user 仅有 user_id）。
typename (#4)	string	-	typename 是上游原样返回的 __typename，便于排查 unavailable 的具体形态。
rate_limit (#5)	RateLimit（见消息定义）	-	-

WebUserTimelineRequest

proto 全名：twitter.web.v1.WebUserTimelineRequest

字段	类型	约束	说明
state (#1)	WebAccountState（见消息定义）	-	-
user_id (#2)	string	-	-
count (#3)	int32	-	count 为 0 时用抓包默认值 30。
cursor (#4)	string	-	TODO(协议核对): 置信度=高概率; 来源=响应里的 cursor-bottom 条目; 抓包未出现翻页请求。

WriteStatusRequest

proto 全名：twitter.android.v1.WriteStatusRequest

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-

WriteStatusResponse

proto 全名：twitter.android.v1.WriteStatusResponse

字段	类型	约束	说明
state (#1)	AndroidAccountState（见消息定义）	-	-
status (#2)	WriteStatus	-	-
writable (#3)	bool	optional	是否可发帖。三态：UNKNOWN 与 RATE_LIMITED 时字段缺席， 表示「没查到」而不是「明确不可写」—— 调用方不得把缺席当成 false，更不得当成 true。
reason (#4)	string	-	限权说明。只有 READ_ONLY_SUSPENDED 时是平台横幅原文（不翻译、不映射）； 其余状态是本服务的固定说明文案，可写时为空串。 ★仅供展示与人工研判，禁止解析它做分类★。
http_status (#5)	int32	-	上游 HomeTimeline 的 HTTP 状态码。因为上游失败在本 RPC 被转成了正常响应， 调用方拿不到 FailureDetail.upstream_http_status，这里是唯一的排障信号。
banner_entry_id (#6)	string	-	命中的限权横幅 entry_id；未命中为空。判据漂移时用于回溯。