base64 编码

向 Document AI API 发送文档文件时，如果文件大小不超过 20 MB，则只能通过在线处理在 RawDocument.content 字段中直接发送数据。输入文件将采用二进制格式，必须先进行编码，然后才能发送到 Document AI。

如果输入文件超出在线处理限制，则必须将其存储在 Cloud Storage 存储桶中才能发送以进行处理，而无需进行编码。如需了解详情，请参阅批量处理文档。

使用命令行

在 gRPC 请求中，您可以直接写出二进制数据；但是，在发出 REST 请求时系统会使用 JSON。JSON 是一种不直接支持二进制数据的文本格式，因此您需要使用 Base64 编码将此类二进制数据转换为文本。

大多数开发环境都包含一个原生 base64 实用程序，用于将二进制文件编码为 ASCII 文本数据。如需对文件进行编码，请按照以下说明操作：

Linux

使用 base64 命令行工具对文件进行编码，请注意，务必使用 -w 0 标志以避免换行：

base64 INPUT_FILE -w 0 > OUTPUT_FILE

macOS

使用 base64 命令行工具对文件进行编码：

base64 -i INPUT_FILE -o OUTPUT_FILE

Windows

使用 Base64.exe 工具对文件进行编码：

Base64.exe -e INPUT_FILE > OUTPUT_FILE

PowerShell

使用 Convert.ToBase64String 方法对文件进行编码：

[Convert]::ToBase64String([IO.File]::ReadAllBytes("./INPUT_FILE")) > OUTPUT_FILE

创建 JSON 请求文件，并内嵌 base64 编码的数据：

JSON

{
  "skipHumanReview": skipHumanReview,
  "rawDocument": {
    "mimeType": "MIME_TYPE",
    "content": "BASE64_ENCODED_DATA"
  },
  "fieldMask": "FIELD_MASK"
}

使用客户端库

通过文本编辑器将二进制数据嵌入请求中既不可取也不实用。在实际使用中，您应在客户端代码中嵌入使用 base64 编码的文件。所有受支持的编程语言都内置有适用于 base64 编码内容的机制。

Python

# Import the base64 encoding library.
import base64

# Pass the image data to an encoding function.
def encode_image(image):
    with open(image, "rb") as image_file:
        encoded_string = base64.b64encode(image_file.read())
    return encoded_string

Node.js

// Read the file into memory.
var fs = require('fs');
var imageFile = fs.