このページは Cloud Translation API によって翻訳されました。

Class Utilities

このサービスは、文字列のエンコードとデコード、日付のフォーマット設定、JSON 操作、その他のさまざまなタスク用のユーティリティを提供します。

プロパティ

プロパティ	タイプ	説明
`Charset`	`Charset`
`DigestAlgorithm`	`DigestAlgorithm`
`MacAlgorithm`	`MacAlgorithm`
`RsaAlgorithm`	`RsaAlgorithm`

メソッド

メソッド	戻り値の型	概要
`base64Decode(encoded)`	`Byte[]`	base64 でエンコードされた文字列を UTF-8 バイト配列にデコードします。
`base64Decode(encoded, charset)`	`Byte[]`	Base64 でエンコードされた文字列を特定の文字セットのバイト配列にデコードします。
`base64DecodeWebSafe(encoded)`	`Byte[]`	base64 ウェブセーフでエンコードされた文字列を UTF-8 バイト配列にデコードします。
`base64DecodeWebSafe(encoded, charset)`	`Byte[]`	Base64 ウェブセーフでエンコードされた文字列を特定の文字セットのバイト配列にデコードします。
`base64Encode(data)`	`String`	指定されたバイト配列から base64 でエンコードされた文字列を生成します。
`base64Encode(data)`	`String`	指定された文字列から base64 でエンコードされた文字列を生成します。
`base64Encode(data, charset)`	`String`	特定の文字セットで指定された文字列から base64 でエンコードされた文字列を生成します。
`base64EncodeWebSafe(data)`	`String`	指定されたバイト配列から base64 ウェブセーフエンコード文字列を生成します。
`base64EncodeWebSafe(data)`	`String`	指定された文字列から Base64 ウェブセーフエンコード文字列を生成します。
`base64EncodeWebSafe(data, charset)`	`String`	特定の文字セットで指定された文字列から、Base64 ウェブセーフでエンコードされた文字列を生成します。
`computeDigest(algorithm, value)`	`Byte[]`	指定された `Byte[]` 値に対して、指定されたアルゴリズムを使用してダイジェストを計算します。
`computeDigest(algorithm, value)`	`Byte[]`	指定された `String` 値に対して、指定されたアルゴリズムを使用してダイジェストを計算します。
`computeDigest(algorithm, value, charset)`	`Byte[]`	指定された文字セットで指定された `String` 値に対して、指定されたアルゴリズムを使用してダイジェストを計算します。
`computeHmacSha256Signature(value, key)`	`Byte[]`	指定されたキーを使用して HMAC-SHA256 で指定された値に署名します。
`computeHmacSha256Signature(value, key)`	`Byte[]`	指定されたキーを使用して HMAC-SHA256 で指定された値に署名します。
`computeHmacSha256Signature(value, key, charset)`	`Byte[]`	指定されたキーと文字セットを使用して、HMAC-SHA256 を使用して指定された値に署名します。
`computeHmacSignature(algorithm, value, key)`	`Byte[]`	指定された鍵と値に対して指定されたアルゴリズムを使用して、メッセージ認証コードを計算します。
`computeHmacSignature(algorithm, value, key)`	`Byte[]`	指定された鍵と値に対して指定されたアルゴリズムを使用して、メッセージ認証コードを計算します。
`computeHmacSignature(algorithm, value, key, charset)`	`Byte[]`	指定された鍵と値に対して指定されたアルゴリズムを使用して、メッセージ認証コードを計算します。
`computeRsaSha1Signature(value, key)`	`Byte[]`	指定された鍵を使用して RSA-SHA1 で指定された値に署名します。
`computeRsaSha1Signature(value, key, charset)`	`Byte[]`	指定された鍵と文字セットを使用して RSA-SHA1 で指定された値に署名します。
`computeRsaSha256Signature(value, key)`	`Byte[]`	指定された鍵を使用して RSA-SHA256 で指定された値に署名します。
`computeRsaSha256Signature(value, key, charset)`	`Byte[]`	指定された鍵を使用して RSA-SHA256 で指定された値に署名します。
`computeRsaSignature(algorithm, value, key)`	`Byte[]`	指定された鍵で指定された RSA アルゴリズムを使用して、指定された値に署名します。
`computeRsaSignature(algorithm, value, key, charset)`	`Byte[]`	指定された鍵と文字セットで指定された RSA アルゴリズムを使用して、指定された値に署名します。
`formatDate(date, timeZone, format)`	`String`	Java SE SimpleDateFormat クラスで説明されている仕様に従って日付を書式設定します。
`formatString(template, args)`	`String`	「%」形式の形式文字列を使用して、`sprintf` のような文字列のフォーマットを実行します。
`getUuid()`	`String`	UUID を文字列として取得します（`java.util.UUID.randomUUID()` メソッドを使用する場合と同じです）。
`gzip(blob)`	`Blob`	`gzip` - 指定された `Blob` データを圧縮し、新しい `Blob` オブジェクトで返します。
`gzip(blob, name)`	`Blob`	`gzip` - 指定された `Blob` データを圧縮し、新しい `Blob` オブジェクトで返します。
`newBlob(data)`	`Blob`	バイト配列から新しい Blob オブジェクトを作成します。
`newBlob(data, contentType)`	`Blob`	バイト配列とコンテンツタイプから新しい Blob オブジェクトを作成します。
`newBlob(data, contentType, name)`	`Blob`	バイト配列、コンテンツタイプ、名前から新しい Blob オブジェクトを作成します。
`newBlob(data)`	`Blob`	文字列から新しい Blob オブジェクトを作成します。
`newBlob(data, contentType)`	`Blob`	文字列とコンテンツタイプから新しい Blob オブジェクトを作成します。
`newBlob(data, contentType, name)`	`Blob`	文字列、コンテンツタイプ、名前から新しい Blob オブジェクトを作成します。
`parseCsv(csv)`	`String[][]`	CSV 文字列の表形式の 2 次元配列表現を返します。
`parseCsv(csv, delimiter)`	`String[][]`	カスタム区切り文字を使用して、CSV 文字列の表形式の 2 次元配列表現を返します。
`parseDate(date, timeZone, format)`	`Date`	Java Standard Edition の `SimpleDateFormat` クラスで説明されている仕様に従って、指定された文字列の日付を解析します。
`sleep(milliseconds)`	`void`	指定したミリ秒数だけスリープします。
`ungzip(blob)`	`Blob`	`Blob` オブジェクトを解凍し、解凍されたデータを含む `Blob` を返します。
`unzip(blob)`	`Blob[]`	ZIP ファイルを表す Blob を受け取り、そのコンポーネントファイルを返します。
`zip(blobs)`	`Blob`	渡された Blob のデータを含む zip ファイルである新しい Blob オブジェクトを作成します。
`zip(blobs, name)`	`Blob`	渡された Blob のデータを含む zip ファイルである新しい Blob オブジェクトを作成します。

サポート終了のメソッド

メソッド	戻り値の型	概要
`jsonParse(jsonString)`	`Object`	渡された JSON 文字列に対応するオブジェクトを返します。
`jsonStringify(obj)`	`String`	渡されたオブジェクトの JSON 文字列を返します。

詳細なドキュメント

`base64Decode(encoded)`

base64 でエンコードされた文字列を UTF-8 バイト配列にデコードします。

// This is the base64 encoded form of "Google グループ"
const base64data = 'R29vZ2xlIOOCsOODq+ODvOODlw==';

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
const decoded = Utilities.base64Decode(base64data);
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

パラメータ

名前	型	説明
`encoded`	`String`	デコードするバイトデータの配列。

戻る

Byte[] - Base64 でエンコードされた引数で表されるバイト配列としての元のデータ。

`base64Decode(encoded, charset)`

base64 でエンコードされた文字列を特定の文字セットのバイト配列にデコードします。

// This is the base64 encoded form of "Google グループ"
const base64data = 'R29vZ2xlIOOCsOODq+ODvOODlw==';

const decoded = Utilities.base64Decode(base64data, Utilities.Charset.UTF_8);

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

パラメータ

名前	型	説明
`encoded`	`String`	デコードするデータの文字列。
`charset`	`Charset`	入力の文字セットを指定する `Charset`。

戻る

Byte[] - Base64 でエンコードされた引数で表されるバイト配列としての元のデータ。

`base64DecodeWebSafe(encoded)`

base64 ウェブセーフでエンコードされた文字列を UTF-8 バイト配列にデコードします。

// This is the base64 web-safe encoded form of "Google グループ"
const base64data = 'R29vZ2xlIOOCsOODq-ODvOODlw==';

const decoded = Utilities.base64DecodeWebSafe(base64data);

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

パラメータ

名前	型	説明
`encoded`	`String`	デコードするウェブセーフデータのバイト配列。

戻る

Byte[] - Base64 ウェブセーフでエンコードされた引数で表される元のデータ（バイト配列）。

`base64DecodeWebSafe(encoded, charset)`

Base64 ウェブセーフでエンコードされた文字列を特定の文字セットのバイト配列にデコードします。

// This is the base64 web-safe encoded form of "Google グループ"
const base64data = 'R29vZ2xlIOOCsOODq-ODvOODlw==';

const decoded = Utilities.base64DecodeWebSafe(
    base64data,
    Utilities.Charset.UTF_8,
);

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

パラメータ

名前	型	説明
`encoded`	`String`	デコードするウェブセーフデータの文字列。
`charset`	`Charset`	入力の文字セットを指定する `Charset`。

戻る

Byte[] - Base64 ウェブセーフでエンコードされた引数で表される元のデータ（バイト配列）。

`base64Encode(data)`

指定されたバイト配列から base64 でエンコードされた文字列を生成します。Base 64 は、バイナリデータを受け入れることができないさまざまなツールで受け入れられる一般的なエンコードです。Base64 は、メール、HTTP などのインターネットプロトコルや XML ドキュメントでよく使用されます。

// Instantiates a blob here for clarity
const blob = Utilities.newBlob('A string here');

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
const encoded = Utilities.base64Encode(blob.getBytes());
Logger.log(encoded);

パラメータ

名前	型	説明
`data`	`Byte[]`	エンコードするデータの byte[]。

戻る

String - 渡されたデータの base64 エンコード表現。

`base64Encode(data)`

指定された文字列から base64 でエンコードされた文字列を生成します。Base 64 は、バイナリデータを受け入れることができないさまざまなツールで受け入れられる一般的なエンコードです。Base64 は、メール、HTTP などのインターネットプロトコルや XML ドキュメントでよく使用されます。

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
const encoded = Utilities.base64Encode('A string here');
Logger.log(encoded);

パラメータ

名前	型	説明
`data`	`String`	エンコードする文字列。

戻る

String - 入力文字列の base64 エンコード表現。

`base64Encode(data, charset)`

特定の文字セットで指定された文字列から base64 でエンコードされた文字列を生成します。文字セットは、文字をエンコードできるようにエンコードする方法です。通常、これらはバイナリ形式で行われますが、通常、特定のデータ伝送プロトコルと互換性がない場合があります。データを互換性のあるものにするために、通常は base64 でエンコードします。これは、バイナリデータを受け入れることができないさまざまなツールで受け入れられる一般的なエンコードです。Base64 は、メール、HTTP などのインターネットプロトコルや XML ドキュメントでよく使用されます。

// "Google Groups" in Katakana (Japanese)
const input = 'Google グループ';

// Writes "R29vZ2xlIOOCsOODq+ODvOODlw==" to the log
const encoded = Utilities.base64Encode(input, Utilities.Charset.UTF_8);
Logger.log(encoded);

パラメータ

名前	型	説明
`data`	`String`	エンコードするデータの文字列。
`charset`	`Charset`	入力の文字セットを指定する `Charset`。

戻る

String - 指定された Charset を含む入力文字列の base64 エンコード表現。

`base64EncodeWebSafe(data)`

指定されたバイト配列から base64 ウェブセーフエンコード文字列を生成します。Base64 は、バイナリデータを受け入れることができないさまざまなツールで受け入れられる一般的なエンコードです。Base 64 ウェブセーフは、メール、HTTP などのインターネットプロトコルや XML ドキュメントでよく使用されます。

// Instantiates a blob here for clarity
const blob = Utilities.newBlob('A string here');

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
const encoded = Utilities.base64EncodeWebSafe(blob.getBytes());
Logger.log(encoded);

パラメータ

名前	型	説明
`data`	`Byte[]`	エンコードするバイトデータの配列。

戻る

String - 渡されたデータの base64 ウェブセーフエンコード表現。

`base64EncodeWebSafe(data)`

指定された文字列から Base64 ウェブセーフエンコード文字列を生成します。Base 64 は、バイナリデータを受け入れることができないさまざまなツールで受け入れられる一般的なエンコードです。Base 64 ウェブセーフは、メール、HTTP などのインターネットプロトコルや XML ドキュメントでよく使用されます。

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
const encoded = Utilities.base64EncodeWebSafe('A string here');
Logger.log(encoded);

パラメータ

名前	型	説明
`data`	`String`	エンコードする文字列。

戻る

String - 入力文字列の Base64 ウェブセーフエンコード表現。

`base64EncodeWebSafe(data, charset)`

特定の文字セットで指定された文字列から、Base64 ウェブセーフでエンコードされた文字列を生成します。文字セットは、文字をエンコードできるようにエンコードする方法です。通常、これらはバイナリ形式で行われますが、通常、特定のデータ伝送プロトコルと互換性がない場合があります。データを互換性のあるものにするために、通常は Base64 でエンコードします。これは、バイナリデータを受け入れることができないさまざまなツールで使用される一般的なエンコードです。Base 64 ウェブセーフは、メール、HTTP などのインターネットプロトコルや XML ドキュメントでよく使用されます。

// "Google Groups" in Katakana (Japanese)
const input = 'Google グループ';

// Writes "R29vZ2xlIOOCsOODq-ODvOODlw==" to the log
const encoded = Utilities.base64EncodeWebSafe(input, Utilities.Charset.UTF_8);
Logger.log(encoded);

パラメータ

名前	型	説明
`data`	`String`	エンコードするデータの文字列。
`charset`	`Charset`	入力の文字セットを指定する `Charset`。

戻る

String - 指定された Charset を含む入力文字列の base64 ウェブセーフエンコード表現。

`computeDigest(algorithm, value)`

指定された Byte[] 値に対して、指定されたアルゴリズムを使用してダイジェストを計算します。

const input = Utilities.base64Decode(
    'aW5wdXQgdG8gaGFzaA0K');  // == base64encode("input to hash")
const digest = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5, input);
Logger.log(digest);

パラメータ

名前	型	説明
`algorithm`	`DigestAlgorithm`	使用する `DigestAlgorithm`。
`value`	`Byte[]`	ダイジェストを計算する入力文字列値。

戻る

Byte[] - 出力ダイジェストを表す byte[]。

`computeDigest(algorithm, value)`

指定された String 値に対して、指定されたアルゴリズムを使用してダイジェストを計算します。

const digest = Utilities.computeDigest(
    Utilities.DigestAlgorithm.MD5,
    'input to hash',
);
Logger.log(digest);

パラメータ

名前	型	説明
`algorithm`	`DigestAlgorithm`	使用する `DigestAlgorithm`。
`value`	`String`	ダイジェストを計算する入力文字列値。

戻る

Byte[] - 出力ダイジェストを表す byte[]。

`computeDigest(algorithm, value, charset)`

指定された文字セットで、指定された String 値に対して指定されたアルゴリズムを使用してダイジェストを計算します。

const digest = Utilities.computeDigest(
    Utilities.DigestAlgorithm.MD5,
    'input to hash',
    Utilities.Charset.US_ASCII,
);
Logger.log(digest);

パラメータ

名前	型	説明
`algorithm`	`DigestAlgorithm`	使用する `DigestAlgorithm`。
`value`	`String`	ダイジェストを計算する入力文字列値。
`charset`	`Charset`	入力文字セットを表す `Charset`。

戻る

Byte[] - 出力ダイジェストを表す byte[]。

`computeHmacSha256Signature(value, key)`

指定されたキーを使用して HMAC-SHA256 で指定された値に署名します。

// This writes an array of bytes to the log.
const input = Utilities.base64Decode(
    'aW5wdXQgdG8gaGFzaA0K');                 // == base64encode("input to hash")
const key = Utilities.base64Decode('a2V5');  // == base64encode("key")
const signature = Utilities.computeHmacSha256Signature(input, key);
Logger.log(signature);

パラメータ

名前	型	説明
`value`	`Byte[]`	ハッシュを生成する入力値。
`key`	`Byte[]`	ハッシュの生成に使用するキー。

戻る

Byte[] - 出力署名を表す byte[]。

`computeHmacSha256Signature(value, key)`

指定されたキーを使用して HMAC-SHA256 で指定された値に署名します。

// This writes an array of bytes to the log.
const signature = Utilities.computeHmacSha256Signature(
    'this is my input',
    'my key - use a stronger one',
);
Logger.log(signature);

パラメータ

名前	型	説明
`value`	`String`	ハッシュを生成する入力値。
`key`	`String`	ハッシュの生成に使用するキー。

戻る

Byte[] - 出力署名を表す byte[]。

`computeHmacSha256Signature(value, key, charset)`

指定されたキーと文字セットを使用して、HMAC-SHA256 を使用して指定された値に署名します。

// This writes an array of bytes to the log.
const signature = Utilities.computeHmacSha256Signature(
    'this is my input',
    'my key - use a stronger one',
    Utilities.Charset.US_ASCII,
);
Logger.log(signature);

パラメータ

名前	型	説明
`value`	`String`	ハッシュを生成する入力値。
`key`	`String`	ハッシュの生成に使用するキー。
`charset`	`Charset`	入力文字セットを表す `Charset`。

戻る

Byte[] - 出力署名を表す byte[]。

`computeHmacSignature(algorithm, value, key)`

指定された鍵と値に対して指定されたアルゴリズムを使用して、メッセージ認証コードを計算します。

// This writes an array of bytes to the log.
const input = Utilities.base64Decode(
    'aW5wdXQgdG8gaGFzaA0K');                 // == base64encode("input to hash")
const key = Utilities.base64Decode('a2V5');  // == base64encode("key")
const signature = Utilities.computeHmacSignature(
    Utilities.MacAlgorithm.HMAC_MD5,
    input,
    key,
);
Logger.log(signature);

パラメータ

名前	型	説明
`algorithm`	`MacAlgorithm`	入力値のハッシュ化に使用する `MacAlgorithm` アルゴリズム。
`value`	`Byte[]`	ハッシュを生成する入力値。
`key`	`Byte[]`	ハッシュの生成に使用するキー。

戻る

Byte[] - 出力署名を表す byte[]。

`computeHmacSignature(algorithm, value, key)`

指定された鍵と値に対して指定されたアルゴリズムを使用して、メッセージ認証コードを計算します。

// This writes an array of bytes to the log.
const signature = Utilities.computeHmacSignature(
    Utilities.MacAlgorithm.HMAC_MD5,
    'input to hash',
    'key',
);
Logger.log(signature);

パラメータ

名前	型	説明
`algorithm`	`MacAlgorithm`	入力値のハッシュ化に使用する `MacAlgorithm` アルゴリズム。
`value`	`String`	ハッシュを生成する入力値。
`key`	`String`	ハッシュの生成に使用するキー。

戻る

Byte[] - 出力署名を表す byte[]。

`computeHmacSignature(algorithm, value, key, charset)`

指定された鍵と値に対して指定されたアルゴリズムを使用して、メッセージ認証コードを計算します。

// This writes an array of bytes to the log.
const signature = Utilities.computeHmacSignature(
    Utilities.MacAlgorithm.HMAC_MD5,
    'input to hash',
    'key',
    Utilities.Charset.US_ASCII,
);
Logger.log(signature);

パラメータ

名前	型	説明
`algorithm`	`MacAlgorithm`	入力値のハッシュ化に使用する `MacAlgorithm` アルゴリズム。
`value`	`String`	ハッシュを生成する入力値。
`key`	`String`	ハッシュの生成に使用するキー。
`charset`	`Charset`	入力文字セットを表す `Charset`。

戻る

Byte[] - 出力署名を表す byte[]。

`computeRsaSha1Signature(value, key)`

指定された鍵を使用して RSA-SHA1 で指定された値に署名します。

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSha1Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
Logger.log(signature);

パラメータ

名前	型	説明
`value`	`String`	ハッシュを生成する入力値。
`key`	`String`	署名の生成に使用する PEM 形式の鍵。

戻る

Byte[] - 出力署名を表す byte[]。

`computeRsaSha1Signature(value, key, charset)`

指定された鍵と文字セットを使用して RSA-SHA1 で指定された値に署名します。

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSha1Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
    Utilities.Charset.US_ASCII,
);
Logger.log(signature);

パラメータ

名前	型	説明
`value`	`String`	ハッシュを生成する入力値。
`key`	`String`	署名の生成に使用する PEM 形式の鍵。
`charset`	`Charset`	入力文字セットを表す `Charset`。

戻る

Byte[] - 出力署名を表す byte[]。

`computeRsaSha256Signature(value, key)`

指定された鍵を使用して RSA-SHA256 で指定された値に署名します。

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSha256Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
Logger.log(signature);

パラメータ

名前	型	説明
`value`	`String`	ハッシュを生成する入力値。
`key`	`String`	署名の生成に使用する PEM 形式の鍵。

戻る

Byte[] - 出力署名を表す byte[]。

`computeRsaSha256Signature(value, key, charset)`

指定された鍵を使用して RSA-SHA256 で指定された値に署名します。

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSha256Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
Logger.log(signature);

パラメータ

名前	型	説明
`value`	`String`	ハッシュを生成する入力値。
`key`	`String`	署名の生成に使用する PEM 形式の鍵。
`charset`	`Charset`	入力文字セットを表す `Charset`。

戻る

Byte[] - 出力署名を表す byte[]。

`computeRsaSignature(algorithm, value, key)`

指定された鍵で指定された RSA アルゴリズムを使用して、指定された値に署名します。

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSignature(
    Utilities.RsaAlgorithm.RSA_SHA_256,
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
Logger.log(signature);

パラメータ

名前	型	説明
`algorithm`	`RsaAlgorithm`	入力値のハッシュ化に使用する `RsaAlgorithm` アルゴリズム。
`value`	`String`	ハッシュを生成する入力値。
`key`	`String`	署名の生成に使用する PEM 形式の鍵。

戻る

Byte[] - 出力署名を表す byte[]。

`computeRsaSignature(algorithm, value, key, charset)`

指定された鍵と文字セットで指定された RSA アルゴリズムを使用して、指定された値に署名します。

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSignature(
    Utilities.RsaAlgorithm.RSA_SHA_256,
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
    Utilities.Charset.US_ASCII,
);
Logger.log(signature);

パラメータ

名前	型	説明
`algorithm`	`RsaAlgorithm`	入力値のハッシュ化に使用する `RsaAlgorithm` アルゴリズム。
`value`	`String`	ハッシュを生成する入力値。
`key`	`String`	署名の生成に使用する PEM 形式の鍵。
`charset`	`Charset`	入力文字セットを表す `Charset`。

戻る

Byte[] - 出力署名を表す byte[]。

`formatDate(date, timeZone, format)`

Java SE SimpleDateFormat クラスで説明されている仕様に従って日付を書式設定します。仕様については、 http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html をご覧ください。

// This formats the date as Greenwich Mean Time in the format
// year-month-dateThour-minute-second.
const formattedDate = Utilities.formatDate(
    new Date(),
    'GMT',
    'yyyy-MM-dd\'T\'HH:mm:ss\'Z\'',
);
Logger.log(formattedDate);

パラメータ

名前	型	説明
`date`	`Date`	文字列としてフォーマットする `Date`。
`timeZone`	`String`	結果の出力タイムゾーン。
`format`	`String`	`SimpleDateFormat` 仕様に基づく形式。

戻る

String - 書式付き文字列として入力された日付。

`formatString(template, args)`

「%」形式の形式文字列を使用して、sprintf のような文字列のフォーマットを実行します。

// " 123.456000"
Utilities.formatString('%11.6f', 123.456);

// "   abc"
Utilities.formatString('%6s', 'abc');

パラメータ

名前	型	説明
`template`	`String`	返される内容を制御する形式文字列。
`args`	`Object...`	テンプレートの「%」プレースホルダに入力するオブジェクト。

戻る

String - 書式設定された文字列。

`getUuid()`

UUID を文字列として取得します（java.util.UUID.randomUUID() メソッドを使用する場合と同じです）。この識別子が、すべての時間と空間で一意であるとは限りません。そのため、一意性が保証される必要がある状況では使用しないでください。

// This assigns a UUID as a temporary ID for a data object you are creating in
// your script.
const myDataObject = {
  tempId: Utilities.getUuid(),
};

戻る

String - UUID の文字列表現。

`gzip(blob)`

gzip - 指定された Blob データを圧縮し、新しい Blob オブジェクトで返します。

const textBlob = Utilities.newBlob(
    'Some text to compress using gzip compression',
);

// Create the compressed blob.
const gzipBlob = Utilities.gzip(textBlob);

パラメータ

名前	型	説明
`blob`	`BlobSource`	`gzip` を使用して圧縮する `Blob` オブジェクト。

戻る

Blob - 圧縮されたデータを含む新しい Blob。

`gzip(blob, name)`

gzip - 指定された Blob データを圧縮し、新しい Blob オブジェクトで返します。このバージョンのメソッドでは、ファイル名を指定できます。

const textBlob = Utilities.newBlob(
    'Some text to compress using gzip compression',
);

// Create the compressed blob.
const gzipBlob = Utilities.gzip(textBlob, 'text.gz');

パラメータ

名前	型	説明
`blob`	`BlobSource`	`gzip` を使用して圧縮する `Blob` オブジェクト。
`name`	`String`	作成する `gzip` ファイルの名前。

戻る

Blob - 圧縮されたデータを含む新しい Blob。

`newBlob(data)`

バイト配列から新しい Blob オブジェクトを作成します。Blob は、バイナリデータを入力として受け取る多くの Apps Script API で使用されます。

// Creates a blob object from a byte array.
const data = [71, 79, 79, 71, 76, 69];
const blob = Utilities.newBlob(data);

// Logs the blob data as a string to the console.
console.log(blob.getDataAsString());

パラメータ

名前	型	説明
`data`	`Byte[]`	blob のバイト数。

戻る

Blob - 新しく作成された Blob。

`newBlob(data, contentType)`

バイト配列とコンテンツタイプから新しい Blob オブジェクトを作成します。Blob は、バイナリデータを入力として受け取る多くの Apps Script API で使用されます。

// Declares a byte array.
const data = [71, 79, 79, 71, 76, 69];

// Declares the content type of the blob.
const contentType = 'application/json';

// Creates a blob object from the byte array and content type.
const blob = Utilities.newBlob(data, contentType);

// Logs the blob data as a string to the console.
console.log(blob.getDataAsString());

// Logs the content type of the blob to the console.
console.log(blob.getContentType());

パラメータ

名前	型	説明
`data`	`Byte[]`	Blob のバイト数。
`contentType`	`String`	blob のコンテンツタイプ。`null` にできます。

戻る

Blob - 新しく作成された Blob。

`newBlob(data, contentType, name)`

バイト配列、コンテンツタイプ、名前から新しい Blob オブジェクトを作成します。Blob は、バイナリデータを入力として受け取る多くの Apps Script API で使用されます。

// Declares a byte array.
const data = [71, 79, 79, 71, 76, 69];

// Declares the content type of the blob.
const contentType = 'application/json';

// Declares the name of the blob.
const name = 'Example blob';

// Creates a blob object from the byte array, content type, and name.
const blob = Utilities.newBlob(data, contentType, name);

// Logs the blob data as a string to the console.
console.log('Blob data:', blob.getDataAsString());

// Logs the content type of the blob to the console.
console.log('Blob content type:', blob.getContentType());

// Logs the name of the blob to the console.
console.log('Blob name:', blob.getName());

パラメータ

名前	型	説明
`data`	`Byte[]`	blob のバイト数。
`contentType`	`String`	- blob のコンテンツタイプ - `null` にできます。
`name`	`String`	blob の名前。`null` にできます。

戻る

Blob - 新しく作成された Blob。

`newBlob(data)`

文字列から新しい Blob オブジェクトを作成します。Blob は、バイナリデータを入力として受け取る多くの Apps Script API で使用されます。

// Declares a string for the blob.
const data = 'GOOGLE';

// Creates a blob object from a string.
const blob = Utilities.newBlob(data);

// Logs the blob data in byte array to the console.
console.log('Blob Data:', blob.getBytes());

パラメータ

名前	型	説明
`data`	`String`	UTF-8 と想定される BLOB の文字列。

戻る

Blob - 新しく作成された Blob。

`newBlob(data, contentType)`

文字列とコンテンツタイプから新しい Blob オブジェクトを作成します。Blob は、バイナリデータを入力として受け取る多くの Apps Script API で使用されます。

// Declares a string for the blob.
const data = 'GOOGLE';

// Declares the content type of blob.
const contentType = 'application/json';

// Creates a blob object from the string and content type.
const blob = Utilities.newBlob(data, contentType);

// Logs the blob data in byte array to the console.
console.log('Blob data:', blob.getBytes());

// Logs the content type of the blob to the console.
console.log(blob.getContentType());

パラメータ

名前	型	説明
`data`	`String`	UTF-8 と想定される BLOB の文字列。
`contentType`	`String`	blob のコンテンツタイプ。`null` にできます。

戻る

Blob - 新しく作成された Blob。

`newBlob(data, contentType, name)`

文字列、コンテンツタイプ、名前から新しい Blob オブジェクトを作成します。Blob は、バイナリデータを入力として受け取る多くの Apps Script API で使用されます。

// Declares a string for the blob.
const data = 'GOOGLE';

// Declares the content type of the blob.
const contentType = 'application/json';

// Declares the name of the blob.
const name = 'Example blob';

// Create a blob object from the string, content type, and name.
const blob = Utilities.newBlob(data, contentType, name);

// Logs the blob data in byte array to the console.
console.log('Blob data:', blob.getBytes());

// Logs the content type of the blob to the console.
console.log('Blob content type:', blob.getContentType());

// Logs the name of the blob to the console.
console.log('Blob name:', blob.getName());

パラメータ

名前	型	説明
`data`	`String`	UTF-8 と想定される BLOB の文字列。
`contentType`	`String`	blob のコンテンツタイプ。`null` にできます。
`name`	`String`	blob の名前 - `null` にできます。

戻る

Blob - 新しく作成された Blob。

`parseCsv(csv)`

CSV 文字列の表形式の 2 次元配列表現を返します。

// This creates a two-dimensional array of the format [[a, b, c], [d, e, f]]
const csvString = 'a,b,c\nd,e,f';
const data = Utilities.parseCsv(csvString);

パラメータ

名前	型	説明
`csv`	`String`	カンマ区切り値（CSV）形式の単一データまたは複数行データを格納する文字列。

戻る

String[][] - CSV 文字列の値を含む 2 次元配列。

`parseCsv(csv, delimiter)`

カスタム区切り文字を使用して、CSV 文字列の表形式の 2 次元配列表現を返します。

// This creates a two-dimensional array of the format [[a, b, c], [d, e, f]]
const csvString = 'a\tb\tc\nd\te\tf';
const data = Utilities.parseCsv(csvString, '\t');

パラメータ

名前	型	説明
`csv`	`String`	カンマ区切り値（CSV）形式の単一データまたは複数行データを格納する文字列。
`delimiter`	`Char`	値の範囲内。

戻る

String[][] - CSV 文字列の値を含む 2 次元配列。

`parseDate(date, timeZone, format)`

Java Standard Edition の SimpleDateFormat クラスで説明されている仕様に従って、指定された文字列の日付を解析します。詳細については、Java の SimpleDateFormat クラスをご覧ください。

// This set of parameters parses the given string as a date in Greenwich Mean
// Time, formatted as year-month-dateThour-minute-second.
const date = Utilities.parseDate(
    '1970-01-01 00:00:00',
    'GMT',
    'yyyy-MM-dd\' \'HH:mm:ss',
);
Logger.log(date);

パラメータ

名前	型	説明
`date`	`String`	日付として解析する文字列値。
`timeZone`	`String`	出力のタイムゾーン。
`format`	`String`	`SimpleDateFormat` 仕様に基づく日付形式。

戻る

Date - 日付として入力された文字列。

`sleep(milliseconds)`

指定したミリ秒数だけスリープします。指定されたミリ秒数の間、スクリプトを即座にスリープ状態にします。最大値は 300000（5 分）です。

// Creates a blob object from a string.
const data = 'GOOGLE';
const blob = Utilities.newBlob(data);

// Puts the script to sleep for 10,000 milliseconds (10 seconds).
Utilities.sleep(10000);

// Logs the blob data in byte array to the console.
console.log(blob.getBytes());

パラメータ

名前	型	説明
`milliseconds`	`Integer`	スリープするミリ秒数。

`ungzip(blob)`

Blob オブジェクトを解凍し、解凍されたデータを含む Blob を返します。

const textBlob = Utilities.newBlob(
    'Some text to compress using gzip compression',
);

// Create the compressed blob.
const gzipBlob = Utilities.gzip(textBlob, 'text.gz');

// Uncompress the data.
const uncompressedBlob = Utilities.ungzip(gzipBlob);

パラメータ

名前	型	説明
`blob`	`BlobSource`	圧縮データの `Blob`。

戻る

Blob - 解凍されたデータを表す Blob。

`unzip(blob)`

ZIP ファイルを表す Blob を受け取り、そのコンポーネントファイルを返します。

const googleFavIconUrl = 'https://www.google.com/favicon.ico';
const googleLogoUrl = 'https://www.google.com/images/srpr/logo3w.png';

// Fetch the Google favicon.ico file and get the Blob data
const faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
const logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and
// logoBlob
const zip = Utilities.zip([faviconBlob, logoBlob], 'google_images.zip');

// This now unzips the blobs
const files = Utilities.unzip(zip);

パラメータ

名前	型	説明
`blob`	`BlobSource`	ZIP ファイル blob。

戻る

Blob[] - コンポーネント blob を表す Blob[]。各 blob の名前は ZIP 内の完全パスで指定されます。

`zip(blobs)`

渡された Blob のデータを含む zip ファイルである新しい Blob オブジェクトを作成します。

const googleFavIconUrl = 'https://www.google.com/favicon.ico';
const googleLogoUrl = 'https://www.google.com/images/srpr/logo3w.png';

// Fetch the Google favicon.ico file and get the Blob data
const faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
const logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and
// logoBlob
const zip = Utilities.zip([faviconBlob, logoBlob]);

パラメータ

名前	型	説明
`blobs`	`BlobSource[]`	圧縮する blob の配列。

戻る

Blob - 入力をアーカイブとして格納した新しい blob。

`zip(blobs, name)`

渡された Blob のデータを含む zip ファイルである新しい Blob オブジェクトを作成します。このバージョンのメソッドでは、ファイル名を指定できます。

const googleFavIconUrl = 'https://www.google.com/favicon.ico';
const googleLogoUrl = 'https://www.google.com/images/srpr/logo3w.png';

// Fetch the Google favicon.ico file and get the Blob data
const faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
const logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and
// logoBlob
const zip = Utilities.zip([faviconBlob, logoBlob], 'google_images.zip');

パラメータ

名前	型	説明
`blobs`	`BlobSource[]`	圧縮する blob の配列。
`name`	`String`	作成する ZIP ファイルの名前。

戻る

Blob - 入力をアーカイブとして格納する新しい blob。

サポート終了のメソッド

`jsonParse(jsonString)`

非推奨。2013 年 11 月より、JSON.parse() に置き換えられました

渡された JSON 文字列に対応するオブジェクトを返します。

// Returns the object { name: "John Smith", company: "Virginia Company"}
const obj = Utilities.jsonParse(
    '{"name":"John Smith","company":"Virginia Company"}',
);

パラメータ

名前	型	説明
`jsonString`	`String`	逆シリアル化する JavaScript オブジェクトの文字列表現。

戻る

Object - 入力の JavaScript オブジェクト表現。

`jsonStringify(obj)`

非推奨。2013 年 11 月より、JSON.stringify() に置き換えられました

渡されたオブジェクトの JSON 文字列を返します。

// Logs: {"name":"John Smith","company":"Virginia Company"}
const person = {
  name: 'John Smith',
  company: 'Virginia Company',
};
const json = Utilities.jsonStringify(person);
Logger.log(json);

パラメータ

名前	型	説明
`obj`	`Object`	JSON にシリアル化する JavaScript オブジェクト

戻る

String - JSON シリアル化された JavaScript オブジェクト