[Google Sheets API] セルを結合、結合解除する

Google Sheets API v4（Java）を使用して、
スプレットシートのセルを結合、結合解除する方法
についてご紹介します。

APIを利用する環境の準備から始める場合や、コードを実行する際は、
⧉[Google Sheets API] Google Sheets API v4をJavaで操作する
を参照ください。

例：requests.add(moveDimension(sheetId)); //実行したいリクエストのMethodを指定

その他のGoogle Sheets APIは、下記の記事を参照ください。
⧉[Google Sheets API] JavaでスプレットシートのメニューとAPIを関連づけてみた

No	目次
1	セルの結合
2	セルの結合解除

1. セルの結合

指定したシートのセルを結合します。
結合方法は下記が指定できます。
・指定範囲を全部結合 ：　MERGE_ALL
・指定範囲を横のみ結合　 ：　MERGE_COLUMNS
・指定範囲を縦のみ結合　 ：　MERGE_ROWS

サンプル コード

public static Request mergeCells(Integer sheetId) {
    Request request = new Request();

    GridRange range = new GridRange(); //結合する範囲
    range.setSheetId(sheetId);         //結合する範囲のシートID
    range.setStartRowIndex(2);         //開始行(0スタート)
    range.setEndRowIndex(4);           //終了行(1スタート)
    range.setStartColumnIndex(1);      //開始列(0スタート)
    range.setEndColumnIndex(3);        //終了列(1スタート)

    MergeCellsRequest r = new MergeCellsRequest();
    r.setRange(range);
    r.setMergeType("MERGE_ALL");       //指定範囲を全部結合
    
    request.setMergeCells(r);
    return request;
}

実行結果
3行目〜4行目、２列目〜３列目のセルが結合されました。

2. セルの結合解除

セルの結合を解除します。

サンプル コード

public static Request unmergeCells(Integer sheetId) {
    Request request = new Request();

    GridRange range = new GridRange(); //結合解除の範囲
    range.setSheetId(sheetId);         //結合解除するシートID
    range.setStartRowIndex(2);         //開始行(0スタート)
    range.setEndRowIndex(4);           //終了行(1スタート)
    range.setStartColumnIndex(1);      //開始列(0スタート)
    range.setEndColumnIndex(3);        //終了列(1スタート)

    UnmergeCellsRequest r = new UnmergeCellsRequest();
    r.setRange(range);
    
    request.setUnmergeCells(r);
    return request;
}

実行結果
セルの結合が解除されました。

おしまい。。