如何通过Google Drive API修改文档中特定占位符/文本的字体颜色？

你的代码核心问题是replaceAllText请求的参数结构错误：你把textStyle直接放在了顶层参数里，但按照Google Docs API规范，替换文本时要应用样式，必须将textStyle嵌套在replaceTextStyle字段下，而非与replaceText平级。

修正后的完整代码如下：

$service = new Google_Service_Docs($client);
$new_doc_id = $copyFile->getId();
$new_doc_name = $copyFile->getName();
$documentId = "$new_doc_id";
$documentName = "$new_doc_name";
$replaceRequests = [];

// 替换指定文本并设置红色字体
$searchText = '<<Doc1.Initial>>';
$replaceRequests[] = [
    'replaceAllText' => [
        'containsText' => [
            'text' => $searchText,
            'matchCase' => false,
        ],
        'replaceText' => $searchText, // 可根据需求替换为实际内容
        'replaceTextStyle' => [
            'foregroundColor' => [
                'color' => [
                    'rgbColor' => [
                        'red' => 1.0,
                        'green' => 0.0,
                        'blue' => 0.0,
                    ],
                ],
            ],
            // 指定仅应用字体颜色样式，避免覆盖原文本其他格式
            'fields' => 'foregroundColor'
        ]
    ]
];

$batchUpdateRequest = new Google_Service_Docs_BatchUpdateDocumentRequest([
    'requests' => $replaceRequests
]);
$response = $service->documents->batchUpdate($documentId, $batchUpdateRequest);

关键说明： #

• replaceTextStyle是API规定的替换文本样式专属字段，所有样式属性必须嵌套在此字段内才会生效。
• fields参数用于精准控制要修改的样式属性，设置为foregroundColor表示仅修改字体颜色，不会破坏原文本的字号、加粗等其他格式。若需同时修改多个样式，用逗号分隔字段名即可，比如'fields' => 'foregroundColor,bold'。

内容的提问来源于stack exchange，提问作者Abdullah Shahab