Google Drive
スプレッドシートを更新
概要
このブロックは、Googleドライブのスプレッドシート内のワークシート内容を更新します（ワークシートの追加も可能）。
更新するワークシートの内容は、変数で指定します。データの形式は、「スプレッドシートを作成」ブロックと同じです。詳しくは、「スプレッドシートを作成」ブロックのリファレンスを参照してください。
既存のGoogleドライブ上のファイル（Google Driveカテゴリーのブロック以外で作成・保存したファイル）も対象とする場合は、GCPサービスアカウントのメールアドレスでそのファイルを共有しておく必要があります。GCPサービスアカウントのメールアドレスは、フローデザイナーの設定のGCPサービスアカウントで確認できます。
セルフサービスプランの場合は、このブロックを使用する前に、Google Sheets APIとGoogle Drive APIを有効にしてください。詳しくは、「基本操作ガイド>ヒント> Google APIを有効にする」を参照してください。
プロパティ
| プロパティ名 | 説明 |
|---|---|
| ブロック名 |
編集パネルに配置した当該ブロックの表示名が変更できます。 ブロックリストパネル中のブロック名は変更されません。 |
| GCPサービスアカウント | このブロックで使用するGCPサービスアカウントを選択します。 |
| ファイル名 |
更新するスプレッドシートのファイル名を指定します。 更新するファイルが存在しない場合は、指定されたファイル名でスプレッドシートが作成されます。 ファイルへのURLも指定可能です。URLは、共有リンクおよびファイルのURL（ウェブブラウザーのアドレス欄に表示）のどちらも指定可能です。 ［変数展開の指定が可能］
|
| ワークシート名 |
更新するシート名を指定します。 指定したワークシート名が存在しない場合は、指定したワークシート名でワークシートを最後尾に追加します。 |
| 開始セル（A1形式） |
データを書き出すセルの位置をA1形式で指定します。空欄の場合は、セルA1が指定されたと見なします。
|
| 開始セルを基点に全てのセルをクリアする |
このチェックボックスにチェックを入れると、［開始セル（A1形式）］に指定されたセルを左上隅とした矩形領域のデータをクリアしたうえで、データを書き出します。 
上図例では、青色部分のデータがクリア対象です（画面外のデータも含む）。 |
| 出力データの変数 | 更新するデータが格納された変数を指定します。 |
| ブロックメモ | このブロックに関するメモが記載できます。このブロックの処理に影響しません。 |
| 親フォルダ名 | データを更新するスプレッドシートが存在するフォルダーを特定したいときに指定します。同名のスプレッドシートが複数のフォルダーに存在するときに使用します。 |
| ヘッダー行を出力する |
ヘッダー行を出力するかしないかを指定します。
|
| 出力するキー |
［出力データの変数］に格納されたデータの内、ここで指定したキーに対するデータのみを出力します。列の並びはここで指定されたキーの順番になります。 キーは、［＋］ボタンをクリックして追加します。 |
| 共有相手 |
共有する相手を選択します。
|
| 付与する権限 |
共有する相手に付与する権限を選択します。
|
| Eメールアドレス |
共有相手として[特定のユーザー]・[グループ]を選択した場合に、メールアドレスを指定します。 メールアドレスは、カンマ（
|
| ドメイン |
共有相手として[ドメイン]を選択した場合に、共有相手のGoogle Workspaceドメインを指定します。 |
| ファイル検索で検出を許可する |
共有する相手として[ドメイン]・[ウェブ上で一般公開]を選択した場合に、ファイル検索でアイテムの検出を許可するかしないかを指定します。
|
| 更新完了を待つ最大時間 |
スプレッドシートの更新が完了（最終更新日時が更新）するまで待つ最大時間を秒単位で指定します。 |
| エラー時の繰り返し回数[1] |
スプレッドシートの更新処理が失敗した場合に、再試行する回数を指定します。デフォルト値は0回です。 |
| 最初の繰り返し間隔[1] |
スプレッドシートの更新処理が失敗した場合の、最初の再試行までの待機時間を秒単位で指定します。デフォルト値は1秒です。 繰り返し間隔は、試行回数が増えるごとに2倍ずつ増加します。ただし、［ |
| 最大の繰り返し間隔[1] |
スプレッドシートの更新処理が失敗した場合の、再試行までの最大待機時間を秒単位で指定します。デフォルト値は60秒です。 再試行を繰り返すごとに待機時間は2倍ずつ長くなりますが、ここで指定した時間を超えることはありません。 |
[1]以下のような通信やサーバーの一時的な問題でスプレッドシートの更新に失敗した場合に、これらのプロパティの設定に従って処理を再試行します。
- 通信エラー
- Googleサーバーの一時的なエラー
- 処理が中断されたことを示すエラー
使用例
ここでは、「クエリーの実行」ブロックと組み合わせた例を紹介します。
「クエリーの実行」ブロックのクエリー結果が格納された変数には、オブジェクトの配列形式でデータが格納されており、本ブロックの入力としてそのまま活用できます。
以下は、MAGELLAN BLOCKSで提供しているBigQueryのカレンダーデータセットから祝日の一覧をGoogleスプレッドシートへ設定する例です。
まず、「クエリーの実行」ブロックを配置し、以下のように設定します。
| プロパティ | 値 | 説明 |
|---|---|---|
| クエリー |
SELECT date, dayofweek.name AS day_of_week, public_holiday.name AS holiday_name FROM `blocks-data-calendar.public.calendar_holiday` WHERE public_holiday.flag = TRUE AND date_int.year >= 2024 ORDER BY date |
2024年以降のすべての祝日を日付順にリストします。 |
| 結果を格納する変数 | _ |
次に、「スプレッドシートを更新」ブロックを配置し、以下のように設定します。
| プロパティ | 値 | 説明 |
|---|---|---|
| ファイル名 | https://docs.google.com/spreadsheets/d/[spreadsheetID]/edit?usp=drive_link |
Googleスプレッドシートのファイル名もしくはURLを指定します。 |
| ワークシート名 | 2024年 |
クエリー結果を書き込む先のワークシート名を指定します。 |
| 出力データの変数 | _ |
クエリー結果が格納された変数を指定します。 |
以上で完成です。
