如何在Python中为Google Sheet设置RTL/LTR？相关库及API支持情况

结论 #

• Google Sheet API支持为工作表或单元格配置RTL（从右到左）/LTR（从左到右）格式，但当前gspread和gspread-formatting这两个主流Python库暂未封装该功能。

详细说明 #

1. API底层支持
   Google Sheet API的工作表属性和单元格文本格式相关文档中，明确包含了RTL/LTR的配置项，说明该功能在API层面是可行的。

2. Python库的现状
   gspread和gspread-formatting目前没有提供直接设置RTL/LTR的现成方法，属于库的功能缺失。

3. 临时实现方案
   若需紧急使用该功能，可以借助gspread的batch_update方法直接调用Google Sheet API的原生接口，手动构造请求体：

   • 设置工作表RTL方向：

     import gspread
     
     gc = gspread.service_account()
     spreadsheet = gc.open("你的目标表格")
     update_request = {
         "requests": [
             {
                 "updateSheetProperties": {
                     "properties": {
                         "sheetId": 你的工作表ID,
                         "rightToLeft": True  # True为RTL，False为LTR
                     },
                     "fields": "rightToLeft"
                 }
             }
         ]
     }
     spreadsheet.batch_update(update_request)
     

   • 设置单元格文本RTL格式：
     可以构造repeatCell或updateCells请求，在textFormat中配置direction参数，可选值为"LEFT_TO_RIGHT"或"RIGHT_TO_LEFT"。

4. 功能请求进度
   目前已在gspread和gspread-formatting的GitHub仓库分别提交了功能请求（编号：gspread#1116、gspread-formatting#43），可关注仓库更新等待官方支持。

内容的提问来源于stack exchange，提问作者Jonathan Livni