Google Sheets モジュール

Last update: Fri Feb 02 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
デジタルコンテンツおよびドキュメント

作成対象：

ユーザー

Adobe Workfront Fusion のシナリオでは、Google Sheets を使用するワークフローを自動化したり、複数のサードパーティアプリケーションやサービスに接続したりできます。

Google Sheets アカウントを Workfront Fusion に接続する方法については、 Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。

アクセス要件

この記事で説明している機能を使用するには、次のアクセス権が必要です。

Adobe Workfront プラン*

Pro 以降

Adobe Workfront ライセンス*

Plan、Work

Adobe Workfront Fusion ライセンス**

現在のライセンス要件：Workfront Fusion ライセンスは必要ありません。

または

従来のライセンス要件：Workfront Fusion for Work Automation and Integration

製品

現在の製品要件：Select または Prime Adobe Workfront プランがある場合、この記事で説明する機能を使用するには Adobe Workfront Fusion と Adobe Workfront を組織で購入する必要があります。Workfront Fusion は、Ultimate Workfront プランに含まれています。

または

レガシー製品要件：この記事で説明する機能を使用するには、組織で Adobe Workfront Fusion と Adobe Workfront を購入する必要があります。

ご利用のプラン、ライセンスタイプまたはアクセス権を確認するには、Workfront 管理者にお問い合わせください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

前提条件

Google スプレッドシートモジュールを使用するには、Google アカウントが必要です。

トリガー

行を監視

スプレッドシートに新規追加されたすべての行から値を取得します。

このモジュールは、以前に入力されたことのない新しい行のみを取得します。このトリガーは、上書きされた行を処理しません。

IMPORTANT

ワークシートに空白の行が含まれている場合、空白の行以降の行は処理されません。

Connection

Google Sheets アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion でのシナリオの作成の記事で、モジュールのアプリまたは web サービスを Workfront Fusion に接続を参照してください。

Spreadsheet

監視するシートが含まれているスプレッドシートを選択します。

Sheet

新しい行を監視するシートを選択します。

Table contains headers

スプレッドシートにヘッダー行を含めるかどうかを選択します。

Yes

モジュールは、出力データとしてヘッダー行を取得しません。

出力内の変数名は、ヘッダーによって呼び出されます。
No

また、このモジュールは、最初のテーブル行を取得します。

出力内の変数名は、A、B、C、D などと呼ばれます。

Row with headers

ヘッダー行の範囲を入力します。例：A1:F1

First table row

テーブルの最初の行の範囲を入力します。例：A1:F1

Value render option

Formatted value

値はセルの書式設定に従って計算され、返信で書式設定されます。書式設定は、リクエスト元のユーザーのロケールではなく、スプレッドシートのロケールに基づいて行われます。例えば、A1 が 1.23、A2 が =A1 で通貨の形式に設定されている場合、A2 は "$1.23" を返します。

Unformatted value

値は計算されますが、返信では書式設定されません。例えば、A1 が 1.23、A2 が =A1 で通貨の形式に設定されている場合、A2 は数値 "1.23" を返します。

Formula

値は計算されません。返信には数式が含まれます。例えば、A1 が 1.23、A2 が =A1 で通貨の形式に設定されている場合、A2 は "=A1" を返します。

Date and time render option

Serial number

日付、時刻、日時、期間の各フィールドを、Lotus 1-2-3 によって一般化された「シリアル番号」形式で倍精度に出力するように指示します。値の整数部分（小数点の左側）は、1899年12月30日からの日数を数えます。小数部分（小数点の右側）は、時間を日の端数として数えます。例えば、1900年1月1日の正午は、1899年12月30日の 2 日後で、正午は半日後なので 0.5 なので 2.5 になります。1900年2 月1日午後 3 時は 33.625 となります。1900 年が閏年ではないことが正しく処理されます。

Formatted string

日付、時間、日時、期間の各フィールドを指定された数値形式（スプレッドシートのロケールに依存）で文字列として出力するように指示します。

Limit

Workfront Fusion が 1 回の実行サイクルで処理する結果の最大数を設定します。

行を追加

このモジュールは、シートに行を追加します。

Google Sheetsモジュールを設定すると、Workfront Fusion に以下のフィールドが表示されます。これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加の Google Sheets フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。

フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 Adobe Workfront Fusion のモジュール間での情報のマッピングを参照してください。

Connection

Mode

スプレッドシートとシートを手動で選択するか、マッピングを行うかを選択します。

メモ：手動マッピングは、新しいスプレッドシートが Workfront Fusion シナリオで作成され、新しく作成されたスプレッドシートにデータをシナリオ内で直接追加する場合などに役立ちます。

Spreadsheet

Google スプレッドシートを選択します。

Sheet

行を追加するシートを選択します。

Column Range

使用する列の範囲を選択します。

Table contains headers

スプレッドシートにヘッダー行を含めるかどうかを選択します。

Yes

モジュールは、出力データとしてヘッダー行を取得しません。

出力内の変数名は、ヘッダーによって呼び出されます。
No

また、このモジュールは、最初のテーブル行を取得します。

出力内の変数名は、A、B、C、D などと呼ばれます。

Values

追加する行の目的のセルを入力またはマッピングします。

Value input option

User entered

値は、ユーザーが UI に入力したかのように解析されます。数値は数値のまま保持されますが、文字列の場合は Google Sheets UI を経由してセルにテキストを入力する時に適用されるルールと同じルールに従って数値、日付、もしくは他の形式に変換される可能性があります。
Raw

ユーザーが入力した値は解析されず、そのまま保存されます。

Insert data option

新しいデータが入力されるときの既存のデータの変更方法を指定します。

Insert rows

行が新しいデータ用に挿入されます。
Overwrite

新しいデータは、書き込まれたエリアの既存のデータを上書きします。シートの末尾にデータを追加すると、新しい行または列が挿入され、データを書き込むことができます。

行の更新

このモジュールでは、選択した行のセルの内容を変更できます。

Connection

Mode

スプレッドシートとシートを手動で選択するか、マッピングを行うかを選択します。

Spreadsheet

Google スプレッドシートを選択します。

Sheet

行を更新するシートを選択します。

Row number

更新する行の数を入力します。

Table contains headers

スプレッドシートにヘッダー行を含めるかどうかを選択します。

Yes

モジュールは、出力データとしてヘッダー行を取得しません。

出力内の変数名は、ヘッダーによって呼び出されます。
No

また、このモジュールは、最初のテーブル行を取得します。

出力内の変数名は、A、B、C、D などと呼ばれます。

Values

変更（更新）する行の目的のセルに値を入力またはマッピングします。

Value input option

User entered

値は、ユーザーが UI に入力したかのように解析されます。数値は数値のまま保持されますが、文字列の場合は Google Sheets UI を経由してセルにテキストを入力する時に適用されるルールと同じルールに従って数値、日付、もしくは他の形式に変換される可能性があります。
Raw

ユーザーが入力した値は解析されず、そのまま保存されます。

行のクリア

指定した行から値を削除します。

Connection

Spreadsheet

行をクリアするシートを含む Google スプレッドシートを選択します。

Sheet

データをクリアするシートを選択します。

Row number

データをクリアする行の数を入力します。例： 23

行を削除

指定した行を削除します。

Connection

Spreadsheet

行をクリアするシートを含む Google スプレッドシートを選択します。

スプレッドシート

行を削除するシートを選択します。

行番号

削除する行の数を入力します。例： 23

セルを取得

選択したセルから値を取得します。

Connection

Spreadsheet

Google スプレッドシートを選択します。

Sheet

データを取得するセルを含むシートを選択します。

Cell

データの取得元のセルの ID を入力します。例： A6

Value render option

Formatted value

Unformatted value

Formula

Date and time render option

Serial number

Formatted string

日付、時間、日時、期間の各フィールドを指定された数値形式（スプレッドシートのロケールに依存）で文字列として出力するように指示します。

セルを更新

Connection

Spreadsheet

Google スプレッドシートを選択します。

Cell

更新するセルの ID を入力します。例： A5

Value

セルの新しい値を入力します。

Value input option

User entered

値は、ユーザーが UI に入力したかのように解析されます。数値は数値のまま保持されますが、文字列の場合は Google Sheets UI を経由してセルにテキストを入力する時に適用されるルールと同じルールに従って数値、日付、もしくは他の形式に変換される可能性があります。
Raw

ユーザーが入力した値は解析されず、そのまま保存されます。

セルのクリア

指定したセルから値を削除します。

Connection

Spreadsheet

セルをクリアするシートを含む Google スプレッドシートを選択します。

Sheet

セルをクリアするシートを選択します。

Cell

クリアするセルの ID を入力します。例：A5

シートを追加

選択したスプレッドシートにシートを新規作成します。

Connection

Spreadsheet

シートを追加する Google スプレッドシートを選択します。

Properties

Title

新しいシートの名前を入力します。
Index

シートの位置を入力します。既定値は 0（シートを最初の場所に配置）です

スプレッドシートの作成

Connection

Title

新しいスプレッドシートの名前を入力します。

Locale

スプレッドシートのロケールを次のいずれかの形式で入力します。

ISO 639-1 言語コード（例： en
ISO 639-2 言語コード（例：haw（639-1 コードが存在しない場合）
ISO 言語コードと国コードの組み合わせ（例： en_US

Recalculation interval

揮発性関数が再計算されるまでの待機時間：

On change

揮発性関数は、変更のたびに更新されます。

On change and every minute

揮発性関数は、変化のたびおよび 1 分ごとに更新されます。

On change and hourly

揮発性関数は、変更のたびおよび 1 時間ごとに更新されます。

Time zone

スプレッドシートのタイムゾーンを選択します。

Number format

スプレッドシート内のすべてのセルのデフォルトの形式を選択します。

Text：テキストの書式設定。例： 1000. 12

Number：数値の書式設定。例： 1,000.12

Percent：割合の書式設定。例： 10. 12%

Currency：通貨の書式設定。例： $1,000.12

Date：日付の書式設定。例： 9/26/2008

Time：時間の形式設定。例： 3:59:00 PM

Date time：日付と時刻の書式設定。例：9/26/08 15:59:00

Scientific 指数の書式設定。例： 1. 01E+03

Sheets

Add をクリックして、スプレッドシートにシートを追加します。各シートに、シートとシートのインデックスのタイトルを入力またはマッピングします。インデックス 0 は最初のシートを表します。

シートを削除

特定のシートを削除します。

Connection

Google Sheets アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion でシナリオを作成するの記事で、モジュールのアプリまたは web サービスを Workfront Fusion に接続を参照してください。

Spreadsheet

Google スプレッドシートを選択します。

Sheet

削除するシートを選択します。

API 呼び出し

このアクションモジュールでは、カスタム API 呼び出しを実行できます。

Connection

[Fusion App] アカウントを Workfront Fusion に接続する方法については、接続の作成Adobe Workfront Fusion - 基本手順を参照してください。

URL

https://sheets.googleapis.com/v4/ への相対パスを入力します。

Method

API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、Adobe Workfront Fusion での HTTP リクエスト方法を参照してください。

Headers

例えば {"Content-type":"application/json"} のように、標準の JSON オブジェクトの形式でリクエストのヘッダーを追加します。Workfront Fusion は認証ヘッダーを追加します。

Query String

API 呼び出しのクエリを標準 JSON オブジェクトの形式で追加します。

Body

標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。

メモ：

if などの条件ステートメントを JSON で使用する場合は、条件ステートメントの外側に引用符を挿入します。

検索

行を検索
行を検索（詳細）
範囲の値を取得
シートをリスト

行を検索

フィルターオプションを使用して行を検索します。

Connection

[Fusion App] アカウントを Workfront Fusion に接続する方法については、接続の作成Adobe Workfront Fusion - 基本手順を参照してください。

Spreadsheet

Google スプレッドシートを選択します。

Sheet

行を検索するシートを選択します。

Table contains headers

スプレッドシートにヘッダー行を含めるかどうかを選択します。Yes オプションが選択されている場合、出力データと出力内の変数名がヘッダーによって呼び出されるので、モジュールはヘッダー行を取得しません。No オプションが選択されている場合、モジュールはまた、出力内の最初のテーブル行と変数名を取得し、その後 A、B、C、D などと呼ばれます。

Column range

操作する列の範囲を選択します。例： A-F

Filter

検索する行のフィルターを設定します。

フィルターについて詳しくは、Adobe Workfront Fusion のシナリオへのフィルターの追加を参照してください。

Sort order

昇順と降順のどちらで並べ替えるかを選択します。

Order by

並べ替える列を選択します。

Value render option

Formatted value

Unformatted value

Formula

Date and time render option

Serial number

Formatted string

日付、時間、日時、期間の各フィールドを指定された数値形式（スプレッドシートのロケールに依存）で文字列として出力するように指示します。

Maximum number of returned rows

Workfront Fusion が 1 回の実行サイクルで返す行の最大数を設定します。

行の検索（詳細）

指定された条件に一致する結果を返します。

Connection

Spreadsheet

検索するシートを含む Google スプレッドシートを選択します。

Sheet

検索する行を含むシートを選択します。

Query

Google Charts Query Language を使用します。例： select * where B = "John"

Google Charts Query Language について詳しくは、Google ドキュメントのクエリー関数リファレンスを参照してください。

範囲の値を取得

Connection

Spreadsheet

Google スプレッドシートを選択します。

Sheet

範囲の内容を取得するシートを選択します。

Range

取得する範囲を入力します。例：A1:D25

Table contains headers

シートにヘッダー行がある場合は、このチェックボックスをオンにする

Row with headers

テーブルヘッダーの範囲を入力します。例：A1:F1このフィールドを空のままにした場合、Workfront Fusion では、指定した範囲の最初の行にヘッダーがあると仮定されます。

Value render option

Formatted value

Unformatted value

Formula

Date and time render option

Serial number

Formatted string

日付、時間、日時、期間の各フィールドを指定された数値形式（スプレッドシートのロケールに依存）で文字列として出力するように指示します。

シートをリスト

このモジュールは、スプレッドシート内のすべてのシートのリストを返します。

Connection

Spreadsheet

リストするシートが含まれている Google スプレッドシートを選択します。

使用の制限

エラー 429: RESOURCE_EXHAUSTED が発生した場合、API のレート制限を超えています。

Google Sheets API には、1 プロジェクトあたり 100 秒あたり 500 個のリクエストと、1 ユーザーあたり 100 秒あたり 100 個のリクエストという制限があります。読み取りと書き込みの制限は、別々に追跡されます。1 日の使用制限はありません。

詳しくは、developers.google.com/sheets/api/limits を参照してください。

ヒントとテクニック

Google シートから空のセルを取得する方法
シートへのシナリオを実行するためのボタンの追加

Google Sheet から空のセルを取得する方法

行の検索（詳細）モジュールとこの式を使用して、空の列を取得します。

select * where E is null

シートへのシナリオを実行するためのボタンの追加

Workfront Fusion で、シナリオに Web フック／カスタム Web フック モジュール／トリガーを挿入し、構成します（Web フックを参照）。
Web フックの URL をコピーします。
シナリオを実行します。
Google Sheet のメインメニューバーから挿入／図面… を選択します。
図面ウィンドウで、ウィンドウの上部近くにある テキストボックス アイコンをクリックします。
ボタンをデザインし、右上隅にある「保存して閉じる」ボタンをクリックします。
ワークシートにボタンが配置されます。ボタンの右上隅にある 3 つの縦並びのドットをクリックします。
メニューから「スクリプトを割り当て.」を選択します。
スクリプト（関数）の名前（例：runScenario）を入力して、「OK」をクリックします。
メインメニューバーから ツール／スクリプトエディター を選択します。
次のコードを挿入します。
- 関数の名前は、手順 9 で指定した名前に対応している必要があります。
- この URL を、手順 2 でコピーした web フックの URL に置き換えます。
```
function runScenario() {
```
```
UrlFetchApp.fetch("");
```
```
}
```
Ctrl + S を押してスクリプトファイルを保存し、プロジェクト名を入力して「OK」をクリックします。
Google Sheets に戻って、新しいボタンをクリックします。
スクリプトに必要な認証を付与します。
Workfront Fusion で、シナリオが正常に実行されたことを確認します。

スプレッドシートでの日付の保存

日付の値を書式設定なしでスプレッドシートに保存した場合、ISO 8601 形式のテキストとしてスプレッドシートに表示されます。ただし、このテキストを理解しない日付に対応する Google Sheets 数式または関数（例：数式 =A1+10) を呼び出すと、次のエラーが表示されます。

Google Sheets が日付を理解できるようにするには、formatDate (date; format; [timezone]) 関数を使用して書式設定します。2 番目の引数として関数に渡される正しい形式は、スプレッドシートのロケール設定によって異なります。

正しい形式を判断するには、次の手順を実行します。

メインメニューバーから ファイル／スプレッドシート 設定を選択して、ロケールを確認または設定します。
適切なロケールを検証／設定したら、メインメニューから形式／数値を選択して、対応する日付と時刻の形式を決定します。形式は、日付と時刻メニュー項目の横に表示されます。
formatDate() 関数に渡す正しい形式を作成するには、 Adobe Workfront Fusion](https://experienceleague.adobe.com/workfront-fusion/functions/tokens-for-date-and-time-formatting.html?lang=ja) の日付と時刻の形式について [ トークンのリストを参照してください。

例：米国ロケールの MM/DD/YYYY HH:mm:ss 形式の使用：

Google Sheets 関数の活用

ビルトイン関数がないが Google Sheets にある場合は、それを利用できます。詳しくは、 Adobe Workfront Fusion](https://experienceleague.adobe.com/docs/workfront/using/adobe-workfront-fusion/functions-in-fusion/map-using-functions.html?lang=ja) での関数の使用による [ マップ項目での Google Sheets 関数の使用を参照してください。

Google Sheets による数から日付への変更の阻止

Google ワークシートでは、テキストとして使用している数字の文字列が日付として解釈されている場合があります。例えば、テキストとして使用するために「1-2019」と入力すると、Google がこれを日付として解釈します。これを防ぐために、数値をプレーンテキストとして書式設定することができます。

Google Sheets で、数値を含む列またはセルをハイライト表示します。
形式／数字／プレインテキスト をクリックします。

Workfront Fusion での別の回避策は、数値の前にアポストロフィ（'）を入力することです（例：'1-2019 または '1/47）。Workfront Fusion からデータが送信された後、セルにはアポストロフィが表示されません。

recommendation-more-help

5f00cc6b-2202-40d6-bcd0-3ee0c2316b43