目录组与账单组 API
按正确路径和 ID 管理团队组，保留 SCIM 所有权并核对成员变更结果。
This page has not been translated into English yet. The original Chinese version is shown below.
Team API key 只能操作当前团队。目录组与账单组是两套 API，前者使用 team_group_…，后者 group_…；组织组 g_/grp_… 不能混入任一路由。
Team directory groups
路径为 /teams/directory-groups，GET 列表、POST 创建；/:groupId 支持 GET、PATCH、DELETE。读取需 read:，写入需 admin:；admin:* 可兼容读，只有 read:* 的写请求返回 401。各路由每团队每分钟 20 次。
列表和成员列表 page 默认 1、pageSize 默认 50、上限 200（更大值截到 200）。创建时 name 去首尾空格，需在 active groups 中唯一，成功 201。
PATCH 至少提供一个字段，省略保留原值。name 可改名，monthlySpendingLimitDollars 为 0–2147483647 的整数美元；清除用 clearMonthlySpendingLimitDollars:true，不能同次又设额度。
目录组成员
GET /:groupId/members 查看。POST /:groupId/members/bulk-add 或 /bulk-remove 接受 userIds，每次最多 100 个 user_… ID。
添加忽略不在团队或已在组的人，addedCount 仅计新成员；移除忽略不在组的人，removedCount 仅计实际删除。因此成功 HTTP 不表示输入数组全部发生变化。
SCIM 组手工增删成员返回 400，需在 IdP 管理。删除目录组要求先清空成员、移除 active SCIM mapping，成功 204。
Billing groups
/teams/groups GET 列表、POST 创建；/:groupId GET/PATCH/DELETE。创建 name 必填，type 当前仅 BILLING 且为默认。GET 可带 ISO billingCycle，不传取当前账期。
PATCH 一次只能更新 name 或 directoryGroupId；null 可解除 directory sync。需要两项时分请求，不套用目录组的多字段 PATCH。
POST/DELETE /:groupId/members 接受 userIds。添加要求成员已在团队且未分给其他账单组；移除后归 Unassigned。SCIM 成员不能由 API 改。创建、修改、删除及成员变更各每分钟 20 次。
删除账单组会把全部历史用量转到 Unassigned，不能恢复；这与删除空目录组的语义不同。