Cloud BOT DocsGoogle Sheets / Add data row
Home > User guide > BOT > How to use the BOT editor > Extention> Google Sheets > Google Sheets / Add data row
Japanese may be displayed on some pages.
App overview
Add a new data row to the Google Sheets.
| Extended Feature URL | cbot-extension://cloud-bot:google-sheets:add-data:1 |
| Provider | Cloud BOT official |
| External communication | Yes *This application communicates with Google Cloud's API. |
| Version | 1 |
| Transaction | Use a transaction for each execution. 2 transactions per execution |
Preconfiguration
Google Cloud Settings
When using the Google Sheets extension, it is necessary to configure Google Cloud beforehand.
Please refer to the detailed instructions here and complete the setup.
Screen description
Input screen
Step1
Authentication method
Select the authentication method.
Service Account: Authenticate using a Google Cloud service account.
Authentication type
Specify the authentication type.
Reference the authentication info from a file: Authenticate using a JSON file.
Enter the authentication info in JSON format: Authenticate by entering credentials in JSON format.
* For authentication information, please refer to this.
Authentication file
This is displayed when you select 'Reference the authentication info from a file' as the authentication type.
Specify the JSON file.
Authentication text (JSON format)
This is displayed when you select 'Enter the authentication info in JSON format' as the authentication type.
Enter the JSON text.
Spreadsheet URL
Specify the URL of the spreadsheet to be edited.
Step2
Sheet name
Select the sheet to add a data row to.
Targeted table position or range (optional)
This option allows you to specify a range of cells to target. If not specified, the target is the entire sheet selected as [Sheet Name]. Refer to this page about a targeted table position or range.
*Notes on the input range for the target table can be found here.
Header row
Specify the header row. Refer to this page about a header row.
* Leave blank if the header row is not necessary. An alphabet is assigned automatically for a column name.
Number of rows to add
Specify a number of rows added to the file.
Specify column order (Optional)
If you want to limit rows to input, specify the column name. The column with no data become blank. You can increase or decrease columns to be displayed by pressing the Add / Delete buttons.
* If multiple columns have the same name, they are displayed in order from left column to right.
* If not specified, all columns are displayed.
Step3
The target table range
The target table range is displayed.
Data
Input data to add. You can increase or decrease data rows by pressing the Add / Delete buttons.
* [Link elements and rows] function is useful to paste group data.
Input format
Specify the input format.
Enter as is: Values will be entered exactly as the user inputs them. Values starting with '=' will not be evaluated as formulas.
Enter as a formula: Values will be parsed in the same way as if entered through the spreadsheet's UI. If you input a formula starting with '=', it will be evaluated as a formula.
Result Screen
Edited data
The results will be displayed.
The number of succeeded added data rows
The number of successfully added data rows is displayed.
The number of failed added data rows
The number of data rows which were failed to add is displayed. Refer to this page for example of failing to add.
対象テーブルについての注意事項
スプレッドシートの入力状況によっては、想定しない場所にデータ行が追加される場合があります。
データ行を追加する際、スプレッドシートの既存のデータを検索し、対象とするセルの入力範囲内の「テーブル」を認識します。
「テーブル」とは、値が格納されている隣接するセルの集まりを指します。
設定した入力範囲内の、最も下にあるテーブルの最初の列を基準とし、値が追加されます。
以下を例に説明します。
このシートには、A1:C2とB4:D6の2つのテーブルがあります。
次の場合、行の追加はB7から始まります。
- 対象テーブル位置または範囲シートを指定しなかった場合（テーブル❷が最後のテーブルであるため）。
- B4またはC5:D5を指定した場合（どちらもテーブル❷の中にあるため）。
- B2:D4を指定した場合（範囲内の最後のテーブルはテーブル❷であるため）。
- A3:G10を指定した場合（範囲内の最後のテーブルはテーブル❷であるため）。
次の場合、行の追加は正常に始まります。
- A1を指定した場合、A3から書き込みを開始します（テーブル➊の中にあるため）。
- E4を指定した場合、E4から書き込みを開始します（どのテーブルもないため）。
- A4を指定した場合、A4から書き込みを開始します（どのテーブルもないため）。