【GAS】URL内の特定箇所を関数でエンコードする方法を解説

Google Apps Script (GAS) を利用して、URL内の特定箇所をエンコードする方法について解説します。エンコードは、URLに含まれる日本語や特殊文字をパーセントエンコーディングに変換することで、ブラウザやサーバーが正しく処理できるようにするために行われます。

1. はじめに

URLエンコードは、特定の文字を安全にURLに含めるために必要です。特に日本語などの非ASCII文字や、一部の特殊文字を扱う場合に重要です。Google Apps Scriptでは、JavaScriptの標準関数を利用してエンコードを行うことができます。

2. encodeURIComponent関数の利用

encodeURIComponent 関数は、URLのコンポーネント（パラメータ値など）をエンコードするために使用します。この関数は、URL内で安全に使用できるように文字列を変換します。

例:

javascript

function encodeURLParameter(parameter) {
return encodeURIComponent(parameter);
}

この関数は、引数として与えられた文字列をエンコードして返します。

使い方の例:

javascript

function testEncode() {
var originalString = "味噌汁 ベーコン";
var encodedString = encodeURLParameter(originalString);
Logger.log(encodedString); // 出力: %E5%91%B3%E5%99%8C%E6%B1%81%20%E3%83%99%E3%83%BC%E3%82%B3%E3%83%B3
}

3. URL全体のエンコード

場合によっては、URL全体をエンコードする必要があるかもしれません。encodeURI 関数は、URL全体をエンコードするために使用されますが、スキーム（http://など）やドメイン部分はエンコードしません。

例:

javascript

function encodeFullURL(url) {
return encodeURI(url);
}

使い方の例:

javascript

function testEncodeFullURL() {
var originalURL = "https://example.com/search?query=味噌汁 ベーコン";
var encodedURL = encodeFullURL(originalURL);
Logger.log(encodedURL); // 出力: https://example.com/search?query=%E5%91%B3%E5%99%8C%E6%B1%81%20%E3%83%99%E3%83%BC%E3%82%B3%E3%83%B3
}

4. 実際のプロジェクトでの活用例

例えば、ユーザーが入力した日本語の検索クエリを含むURLを生成する場合、以下のようにエンコード処理を行います。

例:

javascript

function createSearchURL(query) {
var baseURL = "https://example.com/search?query=";
var encodedQuery = encodeURIComponent(query);
return baseURL + encodedQuery;
}

function testCreateSearchURL() {
var query = "味噌汁 ベーコン";
var searchURL = createSearchURL(query);
Logger.log(searchURL); // 出力: https://example.com/search?query=%E5%91%B3%E5%99%8C%E6%B1%81%20%E3%83%99%E3%83%BC%E3%82%B3%E3%83%B3
}

まとめ

GASを使用してURL内の特定箇所をエンコードすることで、特殊文字や日本語を含む文字列を安全にURLに含めることができます。encodeURIComponent や encodeURI 関数を適切に利用し、エンコードを行うことで、より堅牢でエラーの少ないURL処理を実現しましょう。

コメント