通过PHP/API向Google Sheet追加数据时新行对齐异常问题

我是首次尝试用PHP结合Google Sheets API做任务自动化，新手一枚，若表述有问题请见谅。

我的PHP页面会把CSV文件转换成类似这样的数组：

0,,0,R0VXJ9I7,2,*%*
1,,0,R0VXJ9I7,3,*%*
,,,1,,*%*  

其中逗号代表不同列，*%*代表新行。现在所有步骤都走通了，但有个问题：新追加到Google Sheet的行不是从第一列开始，而是从上一行的结束位置接着往后填，效果如下：

0  |   |0  |R0VXJ9I7   |2
                         1  |   |0  |R0VXJ9I7   |3
                                                  | | |1| 

请问哪里操作错了？求帮助或建议。

我的代码如下：

require '../../data/vendor/autoload.php';
//                       the string comes here as plain text
$oddRow = explode(',*%*',$vl02);
//only for debug @.@
$i = 0;
foreach($oddRow as $preRow){
   $client = new \Google_Client();
   $client->setApplicationName('Google Sheets API');
   $client->setScopes([\Google_Service_Sheets::SPREADSHEETS]);
   $client->setAccessType('offline');
   $path = '../../data/credentials.json';
   $client->setAuthConfig($path);
   $service = new \Google_Service_Sheets($client);
   $spreadsheetId = '#####';//protected for safety
   $spreadsheet = $service->spreadsheets->get($spreadsheetId);
        
   $newRow = explode(',', $preRow);
   echo $newRow[$i];   //debug
   echo $i;            //debug
   $i++;               //debug  
   $rows = [$newRow];
            
   $valueRange = new \Google_Service_Sheets_ValueRange();
   $valueRange->setValues($rows);
   $range = '####';//protected for safety 
   $options = ['valueInputOption' => 'USER_ENTERED'];
   $service->spreadsheets_values->append($spreadsheetId, $range, $valueRange, $options);    
}

问题原因及修复方案 #

1. 重复初始化客户端：循环内每次创建Google_Client和Google_Service_Sheets实例，既低效又可能引发异常，需将这部分代码移到循环外部。
2. Range参数错误：若$range指定的是单个单元格而非整个工作表，API会从该位置开始追加数据而非新行。应将$range设为工作表名称（如'Sheet1'），让API自动定位到工作表最后一行的下方。
3. 未指定插入新行选项：调用append方法时需添加insertDataOption参数并设置为INSERT_ROWS，确保新数据插入全新行，而非追加到上一行末尾。
4. 未处理空行：explode(',*%*', $vl02)可能生成空字符串元素（比如原字符串以*%*结尾），循环时需跳过此类空行，避免追加无效数据。

修复后的代码 #

require '../../data/vendor/autoload.php';

// 只初始化一次Google客户端和服务
$client = new \Google_Client();
$client->setApplicationName('Google Sheets API');
$client->setScopes([\Google_Service_Sheets::SPREADSHEETS]);
$client->setAccessType('offline');
$path = '../../data/credentials.json';
$client->setAuthConfig($path);
$service = new \Google_Service_Sheets($client);

$spreadsheetId = '#####'; // 替换为你的表格ID
$range = 'Sheet1'; // 替换为你的工作表名称
$options = [
    'valueInputOption' => 'USER_ENTERED',
    'insertDataOption' => 'INSERT_ROWS' // 强制插入新行
];

// 处理CSV数据
$oddRow = explode(',*%*', $vl02);

foreach($oddRow as $preRow){
    $preRow = trim($preRow);
    if(empty($preRow)) continue; // 跳过空行
    
    $newRow = explode(',', $preRow);
    $rows = [$newRow];
            
    $valueRange = new \Google_Service_Sheets_ValueRange();
    $valueRange->setValues($rows);
    
    // 追加数据到表格
    $service->spreadsheets_values->append($spreadsheetId, $range, $valueRange, $options);    
}

内容的提问来源于stack exchange，提问作者ja rpa