ブロックリファレンス

BLOCKS Reference

Google Drive

クエリーの結果からスプレッドシートを更新

概要

このブロックは、クエリーの結果からGoogleドライブのスプレッドシート内のワークシート内容を更新します（ワークシートの追加も可能）。

クエリーの結果からスプレッドシートを更新ブロックの概念図
（図をクリックすると拡大表示されます。）

既存のGoogleドライブ上のファイル（Google Driveカテゴリーのブロック以外で作成・保存したファイル）も対象とする場合は、GCPサービスアカウントのメールアドレスでそのファイルを共有しておく必要があります。GCPサービスアカウントのメールアドレスは、フローデザイナーの設定のGCPサービスアカウントで確認できます。

warningセルフサービスプランの場合は、このブロックを使用する前に、Google Sheets APIとGoogle Drive APIを有効にしてください。詳しくは、「基本操作ガイド>ヒント> Google APIを有効にする」を参照してください。

プロパティ

プロパティ名 説明
ブロック名

編集パネルに配置した当該ブロックの表示名が変更できます。

ブロックリストパネル中のブロック名は変更されません。
GCPサービスアカウント このブロックで使用するGCPサービスアカウントを選択します。
ファイル名

更新するスプレッドシートのファイル名を指定します。

更新するファイルが存在しない場合は、指定されたファイル名でスプレッドシートが作成されます。

ファイルへのURLも指定可能です。URLは、共有リンクおよびファイルのURL（ウェブブラウザーのアドレス欄に表示）のどちらも指定可能です。

［変数展開の指定が可能］
ワークシート名

更新するシート名を指定します。

指定したワークシート名が存在しない場合は、指定したワークシート名でワークシートを最後尾に追加します。

［変数展開の指定が可能］［%形式の文字列書式の指定が可能］
開始セル（A1形式）

データを書き出すセルの位置をA1形式で指定します。空欄の場合は、セルA1が指定されたと見なします。

A1:D10のような範囲指定もできます。例えば、B2:D5と指定した場合、セルB2からセルD5までの範囲（下図赤枠の部分）にデータを書き出します。書き込むデータがこの範囲より大きい場合は、エラーとなりこのブロックの処理は失敗します。

範囲指定の例
開始セルを基点に全てのセルをクリアする

このチェックボックスにチェックを入れると、［開始セル（A1形式）］に指定されたセルを左上隅とした矩形領域のデータをクリアしたうえで、データを書き出します。

開始セルを基点に全てのセルをクリアするプロパティの解説図

上図例では、青色部分のデータがクリア対象です（画面外のデータも含む）。
クエリー

スプレッドシートの入力となるクエリーを指定します。

クエリ接頭辞（#legacySQL/#standardSQL）を指定すると、［SQL文法］プロパティの指定に関わらず、クエリ接頭辞に指定したSQL文法でクエリーが実行されます。

をクリックすると、指定されたクエリーをクリップボードへコピーします。コピーの際、フロー間共通変数は、設定値に置き換わります。フロー間共通変数を置き換えたくない場合は、ウェブブラウザーのコピー機能を利用してください（例：コピーしたい部分を範囲選択して、マウスの右ボタンクリックで表示されるメニューから「コピー」をクリック）。

  • 変数展開の指定が可能
  • %形式の文字列書式の指定が可能

    ［クエリー内の%形式の文字列書式を有効にする］プロパティのチェックボックスにチェックが付いているときのみ有効です。

    %Yや%mなどの%形式の文字列書式をBigQueryにそのまま渡したい場合は、%の部分を%%としてください。例えば、%Yや%mの場合は、%%Y、%%mとします。BLOCKSにより%%が%へ変換され、%Y、%mがBigQueryに渡ります。
クエリー内の%形式の文字列書式を有効にする

クエリー内の%形式の文字列書式を有効にするかしないかを指定します。

  • チェックボックスオン：クエリー内の%形式の文字列書式が有効
  • チェックボックスオフ：クエリー内の%形式の文字列書式が無効

クエリー内でFORMAT_TIMESTAMP関数やPARSE_TIMESTAMP関数などのように%を含む「形式設定文字列」を使う場合は、%を%%に置き換える必要がなくなるため、このチェックをオフにすると便利です。
ブロックメモ このブロックに関するメモが記載できます。このブロックの処理に影響しません。
親フォルダ名 データを更新するスプレッドシートが存在するフォルダーを特定したいときに指定します。同名のスプレッドシートが複数のフォルダーに存在するときに使用します。
ヘッダー行を出力する

ヘッダー行を出力するかしないかを指定します。

  • ヘッダー行を出力する場合は、チェックを付けます。
  • ヘッダー行を出力しない場合は、チェックを外す。
出力するキー

［出力データの変数］に格納されたデータの内、ここで指定したキーに対するデータのみを出力します。列の並びはここで指定されたキーの順番になります。

キーは、［＋］ボタンをクリックして追加します。
共有相手

共有する相手を選択します。

  • [特定のユーザー]:特定のユーザーと共有します。
  • [グループ]:特定のGoogle グループと共有します。
  • [ドメイン]:特定のGoogle Workspace ドメインと共有します。
  • [ウェブ上で一般公開]: 誰でもアイテムにアクセスできるようにします。
付与する権限

共有する相手に付与する権限を選択します。

  • [編集]:アイテムの編集ができます。
  • [閲覧（コメント可）]: アイテムの閲覧とコメントができます。
  • [閲覧]:アイテムの閲覧のみができます。
Eメールアドレス

共有相手として[特定のユーザー]・[グループ]を選択した場合に、メールアドレスを指定します。

メールアドレスは、カンマ（,）区切りで複数のメールアドレスを列挙できます（例：foo@example.jp, bar@example.jp, baz@example.jp）。

  • [特定のユーザー]: ユーザーのメールアドレスを指定します。
  • [グループ]: Google グループのメールアドレスを指定します。
［変数展開の指定が可能］［%形式の文字列書式の指定が可能］
ドメイン

共有相手として [ドメイン]を選択した場合に、共有相手のGoogle Workspaceドメインを指定します。

［変数展開の指定が可能］［%形式の文字列書式の指定が可能］
ファイル検索で検出を許可する

共有する相手として[ドメイン]・[ウェブ上で一般公開]を選択した場合に、ファイル検索でアイテムの検出を許可するかしないかを指定します。

  • アイテムの検出を許可するときはチェックを付けます。
  • アイテムの検出を許可しないときはチェックを外します。
更新完了を待つ最大時間

スプレッドシートの更新が完了（最終更新日時が更新）するまで待つ最大時間を秒単位で指定します。
クエリー文をログへ出力

クエリー文をログへ出力するかどうかの指定です。ログに出力するクエリー文は、変数が展開されて出力されます。

クエリー文をログへ出力する場合は、チェックボックスにチェックを入れてください。
エラー時の繰り返し回数[1]

スプレッドシートの更新処理が失敗した場合に、再試行する回数を指定します。デフォルト値は0回です。
最初の繰り返し間隔[1]

スプレッドシートの更新処理が失敗した場合の、最初の再試行までの待機時間を秒単位で指定します。デフォルト値は1秒です。

繰り返し間隔は、試行回数が増えるごとに2倍ずつ増加します。ただし、［最大の繰り返し間隔］で指定した値を超えることはありません。
最大の繰り返し間隔[1]

スプレッドシートの更新処理が失敗した場合の、再試行までの最大待機時間を秒単位で指定します。デフォルト値は60秒です。

再試行を繰り返すごとに待機時間は2倍ずつ長くなりますが、ここで指定した時間を超えることはありません。

[1]以下のような通信やサーバーの一時的な問題でスプレッドシートの更新に失敗した場合に、これらのプロパティの設定に従って処理を再試行します。

  • 通信エラー
  • Googleサーバーの一時的なエラー
  • 処理が中断されたことを示すエラー

クエリー結果のデータは一定量ずつ処理されるため、各処理ごとに独立して再試行が行われます。そのため、処理全体で実際の再試行回数が［エラー時の繰り返し回数］の設定値を超える可能性があります。

この情報は役に立ちましたか？