数据结构：Signature Request Edit Embedded Request

使用 `files[]` 指示要发送以供签名的上传文件。 此 Endpoint 需要 **files** 或 **file_urls[]**，但不能同时使用两者。

使用 `file_urls[]` 让 Dropbox Sign 下载文件以发送签名。 此 Endpoint 需要 **files** 或 **file_urls[]**，但不能同时使用两者。

将签名者添加到您的签名请求中。 此 Endpoint 需要 **signers** 或 **grouped_signers**，但不能同时要求两者。

将分组签名者添加到您的签名请求中。 此 Endpoint 需要 **signers** 或 **grouped_signers**，但不能同时要求两者。

如果 `true`，则允许签名者拒绝签署文档。默认为 `false`。

如果设置为 `true`，则允许签名者将其签名请求重新分配给其他签名者。默认为 `false`。 **注意：** 仅适用于高级计划。

描述附件的列表

应抄送的电子邮件地址。

您用来创建此嵌入式签名请求的应用程序的客户端 ID。用于安全目的。

当与合并字段一起使用时，`custom_fields` 允许用户将预填充的数据添加到其签名请求中。 通过使用 `form_fields_per_document` 或 [文本标签](https://app.hellosign.com/api/textTagsWalkthrough#TextTagIntro) 添加合并字段，同时在一次 API 调用中将值与 `custom_fields` 一起传回，可以将预填充数据与“发送一次”签名请求一起使用。 为了在可重复的签名请求上使用预填充，合并字段将添加到 Dropbox Sign UI 中的模板中，或者通过调用 [/template/create_embedded_draft](/api/reference/operation/templateCreateEmbeddedDraft)，然后在引用该模板的后续签名请求上传递 `custom_fields`。

`form_fields_per_document` 中定义的字段的组信息。带有 `group_label` 和 `requirement` 键的字符串索引 JSON 数组。 `form_fields_per_document` 必须包含引用 `form_field_groups` 中定义的组的字段。

`form_fields_per_document` 中定义的字段的条件逻辑规则。

应出现在文档中的字段，表示为对象数组。 （有关更多详细信息，您可以在这里阅读：[使用每个文档的表单字段](/docs/openapi/form-fields-per-document)。） **注意：** 像 **text**、**dropdown**、**checkbox**、**radio** 和 **hyperlink** 等字段具有额外的必填和可选参数。查看这些字段类型的[附加参数](/api/reference/constants/#form-fields-per-document)列表。 * 文本字段使用`SubFormFieldsPerDocumentText` * 下拉字段使用`SubFormFieldsPerDocumentDropdown` * 超链接字段使用`SubFormFieldsPerDocumentHyperlink` * 复选框字段使用 `SubFormFieldsPerDocumentCheckbox` * 无线电现场使用`SubFormFieldsPerDocumentRadio` * 签名字段使用`SubFormFieldsPerDocumentSignature` * 签名日期 字段使用 `SubFormFieldsPerDocumentDateSigned` * 缩写 现场使用 `SubFormFieldsPerDocumentInitials` * 文本合并字段使用`SubFormFieldsPerDocumentTextMerge` * 复选框合并字段使用 `SubFormFieldsPerDocumentCheckboxMerge`

设置为 true 时启用自动文本标签删除。 **注意：** 以这种方式删除文本标签可能会导致不必要的剪辑。我们建议将此设置保留为 `false`，并使用白色文本或类似方法隐藏文本标签。有关详细信息，请参阅[文本标签演练](https://app.hellosign.com/api/textTagsWalkthrough#TextTagIntro)。

将发送给签名者的电子邮件中的自定义消息。

应附加到签名请求的键值数据。此元数据包含在涉及签名请求的所有 API 响应和事件中。例如，使用元数据字段来存储签名者的订单号，以便在接收签名请求的事件时进行查找。 每个请求最多可包含 10 个元数据键（或 50 个嵌套元数据键），键名称最长可达 40 个字符，值最长可达 1000 个字符。

将发送给签名者的电子邮件中的主题。

无论这是一个测试，如果设置为`true`，签名请求将不具有法律约束力。默认为 `false`。

您要分配给 SignatureRequest 的标题。

如果您希望在文档中启用 [文本标签](https://app.hellosign.com/api/textTagsWalkthrough#TextTagIntro) 解析，请发送值 `true`。默认为禁用，或 `false`。

控制[自动填充字段](https://faq.hellosign.com/hc/en-us/articles/360051467511-Auto-Fill-Fields)是否可以在签名期间自动填充签名者的信息。 **注意：** 在使用此功能之前，请确保签名请求中的_签名者是预期方_，以确保签名者信息的安全。

签名请求何时到期。未签名的签名将转为过期状态，并且不再可签名。详情请参阅[签名请求到期日期](https://developers.hellosign.com/docs/signature-request/expiration/)。