//native
export type DynSelect_sheet_name = string
// Dropdown of the spreadsheet's worksheet (tab) names.
export async function sheet_name(auth: RT.Gsheets, spreadsheet_id: string) {
const response = await fetch(
`https://sheets.googleapis.com/v4/spreadsheets/${spreadsheet_id}?fields=sheets.properties.title`,
{
headers: {
Authorization: `Bearer ${auth.token}`,
Accept: "application/json",
},
}
)
if (!response.ok) {
throw new Error(`${response.status} ${await response.text()}`)
}
const { sheets } = (await response.json()) as {
sheets: { properties: { title: string } }[]
}
return sheets.map((s) => ({
value: s.properties.title,
label: s.properties.title,
}))
}
// A1 range without the tab name (A1:F1, B:B, 2:2, C3) → GridRange; omitted bounds stay open.
function gridRange(sheetId: number, range: string) {
const m = range.toUpperCase().match(/^([A-Z]*)(\d*)(?::([A-Z]*)(\d*))?$/)
if (!m || range === "") throw new Error(`Invalid A1 range "${range}"`)
const [, c1, r1, c2 = c1, r2 = r1] = m
const col = (c: string) =>
[...c].reduce((n, ch) => n * 26 + ch.charCodeAt(0) - 64, 0)
const grid: { [key: string]: number } = { sheetId }
if (c1) grid.startColumnIndex = col(c1) - 1
if (c2) grid.endColumnIndex = col(c2)
if (r1) grid.startRowIndex = Number(r1) - 1
if (r2) grid.endRowIndex = Number(r2)
return grid
}
/**
* Merge Cells
* Merge a range (A1 notation without the tab name, e.g. `A1:D1`) into one cell, or per row/column; only the top-left value is kept. `UNMERGE` splits every merged cell in the range.
*/
export async function main(
auth: RT.Gsheets,
spreadsheet_id: string,
sheet_name: DynSelect_sheet_name,
range: string,
merge_type:
"MERGE_ALL" | "MERGE_ROWS" | "MERGE_COLUMNS" | "UNMERGE" = "MERGE_ALL"
) {
const headers = {
Authorization: `Bearer ${auth.token}`,
Accept: "application/json",
}
const meta = await fetch(
`https://sheets.googleapis.com/v4/spreadsheets/${spreadsheet_id}?fields=sheets.properties(sheetId,title)`,
{ headers }
)
if (!meta.ok) {
throw new Error(`${meta.status} ${await meta.text()}`)
}
const { sheets } = (await meta.json()) as {
sheets: { properties: { sheetId: number; title: string } }[]
}
const sheet = sheets.find((s) => s.properties.title === sheet_name)
if (!sheet) throw new Error(`Worksheet "${sheet_name}" not found`)
const sheetId = sheet.properties.sheetId
const grid = gridRange(sheetId, range)
const requests = [
merge_type === "UNMERGE"
? { unmergeCells: { range: grid } }
: { mergeCells: { range: grid, mergeType: merge_type } },
]
const response = await fetch(
`https://sheets.googleapis.com/v4/spreadsheets/${spreadsheet_id}:batchUpdate`,
{
method: "POST",
headers: { ...headers, "Content-Type": "application/json" },
body: JSON.stringify({ requests }),
}
)
if (!response.ok) {
throw new Error(`${response.status} ${await response.text()}`)
}
return await response.json()
}
Submitted by hugo989 2 hours ago