Class Utilities

خدمات رفاهی

این سرویس ابزارهایی برای رمزگذاری/رمزگشایی رشته، قالب‌بندی تاریخ، دستکاری JSON و سایر کارهای متفرقه ارائه می‌دهد.

خواص

ملک نوع توضیحات
Charset Charset
Digest Algorithm Digest Algorithm
Mac Algorithm Mac Algorithm
Rsa Algorithm Rsa Algorithm

روش‌ها

روش نوع بازگشتی شرح مختصر
base64Decode(encoded) Byte[] یک رشته کدگذاری شده با مبنای ۶۴ را به یک آرایه بایتی UTF-8 رمزگشایی می‌کند.
base64Decode(encoded, charset) Byte[] یک رشته کدگذاری شده در مبنای ۶۴ را به یک آرایه بایتی در یک مجموعه کاراکتر خاص رمزگشایی می‌کند.
base64DecodeWebSafe(encoded) Byte[] یک رشته کدگذاری شده تحت وب با استاندارد پایه ۶۴ را به یک آرایه بایتی UTF-8 رمزگشایی می‌کند.
base64DecodeWebSafe(encoded, charset) Byte[] یک رشته کدگذاری شده تحت وب با مبنای ۶۴ را به یک آرایه بایتی در یک مجموعه کاراکتر خاص رمزگشایی می‌کند.
base64Encode(data) String یک رشته کدگذاری شده با مبنای ۶۴ از آرایه بایت داده شده تولید می‌کند.
base64Encode(data) String یک رشته کدگذاری شده با مبنای ۶۴ را از رشته داده شده تولید می‌کند.
base64Encode(data, charset) String یک رشته کدگذاری شده با مبنای ۶۴ را از رشته داده شده در یک مجموعه کاراکتر خاص تولید می‌کند.
base64EncodeWebSafe(data) String یک رشته کدگذاری شده مبتنی بر وب ۶۴ بیتی را از آرایه بایت داده شده تولید می‌کند.
base64EncodeWebSafe(data) String یک رشته کدگذاری شده مبتنی بر وب ۶۴ بیتی را از رشته داده شده تولید می‌کند.
base64EncodeWebSafe(data, charset) String یک رشته کدگذاری شده مبتنی بر وب ۶۴ بیتی را از رشته داده شده در یک مجموعه کاراکتر خاص تولید می‌کند.
compute Digest(algorithm, value) Byte[] با استفاده از الگوریتم مشخص شده روی مقدار مشخص شده Byte[] خلاصه‌ای از داده‌ها را محاسبه کنید.
compute Digest(algorithm, value) Byte[] با استفاده از الگوریتم مشخص شده روی مقدار String مشخص شده، خلاصه‌ای از آن را محاسبه کنید.
compute Digest(algorithm, value, charset) Byte[] با استفاده از الگوریتم مشخص شده، خلاصه‌ای از مقدار String مشخص شده با مجموعه کاراکتر داده شده محاسبه کنید.
compute Hmac Sha256Signature(value, key) Byte[] مقدار ارائه شده را با استفاده از HMAC-SHA256 و با کلید داده شده امضا می‌کند.
compute Hmac Sha256Signature(value, key) Byte[] مقدار ارائه شده را با استفاده از HMAC-SHA256 و با کلید داده شده امضا می‌کند.
compute Hmac Sha256Signature(value, key, charset) Byte[] مقدار ارائه شده را با استفاده از HMAC-SHA256 و با کلید و مجموعه کاراکترهای داده شده امضا می‌کند.
compute Hmac Signature(algorithm, value, key) Byte[] با استفاده از الگوریتم مشخص شده روی کلید و مقدار مشخص شده، یک کد احراز هویت پیام محاسبه کنید.
compute Hmac Signature(algorithm, value, key) Byte[] با استفاده از الگوریتم مشخص شده روی کلید و مقدار مشخص شده، یک کد احراز هویت پیام محاسبه کنید.
compute Hmac Signature(algorithm, value, key, charset) Byte[] با استفاده از الگوریتم مشخص شده روی کلید و مقدار مشخص شده، یک کد احراز هویت پیام محاسبه کنید.
compute Rsa Sha1Signature(value, key) Byte[] مقدار ارائه شده را با استفاده از RSA-SHA1 و با کلید داده شده امضا می‌کند.
compute Rsa Sha1Signature(value, key, charset) Byte[] مقدار ارائه شده را با استفاده از RSA-SHA1 و با کلید و مجموعه کاراکتر داده شده امضا می‌کند.
compute Rsa Sha256Signature(value, key) Byte[] مقدار ارائه شده را با استفاده از RSA-SHA256 و با کلید داده شده امضا می‌کند.
compute Rsa Sha256Signature(value, key, charset) Byte[] مقدار ارائه شده را با استفاده از RSA-SHA256 و با کلید داده شده امضا می‌کند.
compute Rsa Signature(algorithm, value, key) Byte[] مقدار ارائه شده را با استفاده از الگوریتم RSA مشخص شده و با کلید داده شده امضا می‌کند.
compute Rsa Signature(algorithm, value, key, charset) Byte[] مقدار ارائه شده را با استفاده از الگوریتم RSA مشخص شده با کلید و مجموعه کاراکتر داده شده امضا می‌کند.
format Date(date, timeZone, format) String تاریخ را طبق مشخصات شرح داده شده در کلاس SimpleDateFormat در Java SE قالب‌بندی می‌کند.
format String(template, args) String قالب‌بندی رشته‌ای شبیه به sprintf را با استفاده از رشته‌های قالب‌بندی به سبک '%' انجام می‌دهد.
get Uuid() String یک UUID را به صورت رشته دریافت می‌کند (معادل استفاده از متد java.util.UUID.randomUUID() ).
gzip(blob) Blob gzip - داده‌های Blob ارائه شده را فشرده کرده و آن را در یک شیء Blob جدید برمی‌گرداند.
gzip(blob, name) Blob gzip - داده‌های Blob ارائه شده را فشرده کرده و آن را در یک شیء Blob جدید برمی‌گرداند.
new Blob(data) Blob یک شیء Blob جدید از یک آرایه بایت ایجاد می‌کند.
new Blob(data, contentType) Blob یک شیء Blob جدید از یک آرایه بایت و نوع محتوا ایجاد کنید.
new Blob(data, contentType, name) Blob یک شیء Blob جدید از یک آرایه بایت، نوع محتوا و نام ایجاد کنید.
new Blob(data) Blob یک شیء Blob جدید از یک رشته ایجاد می‌کند.
new Blob(data, contentType) Blob یک شیء Blob جدید از یک رشته و نوع محتوا ایجاد کنید.
new Blob(data, contentType, name) Blob یک شیء Blob جدید از یک رشته، نوع محتوا و نام ایجاد کنید.
parse Csv(csv) String[][] یک آرایه دوبعدی جدولی از یک رشته CSV را برمی‌گرداند.
parse Csv(csv, delimiter) String[][] یک آرایه دوبعدی جدولی از یک رشته CSV را با استفاده از یک جداکننده سفارشی برمی‌گرداند.
parse Date(date, timeZone, format) Date رشته‌ی تاریخ ارائه شده را طبق مشخصات شرح داده شده در کلاس Simple Date Format ویرایش استاندارد جاوا تجزیه می‌کند.
sleep(milliseconds) void به مدت زمان مشخصی (بر حسب میلی ثانیه) به حالت خواب می‌رود.
ungzip(blob) Blob یک شیء Blob را از حالت فشرده خارج کرده و یک Blob حاوی داده‌های فشرده نشده را برمی‌گرداند.
unzip(blob) Blob[] یک Blob که نشان‌دهنده‌ی یک فایل زیپ است را می‌گیرد و فایل‌های تشکیل‌دهنده‌ی آن را برمی‌گرداند.
zip(blobs) Blob یک شیء Blob جدید ایجاد می‌کند که یک فایل زیپ است و حاوی داده‌های Blobهای ارسالی می‌باشد.
zip(blobs, name) Blob یک شیء Blob جدید ایجاد می‌کند که یک فایل زیپ است و حاوی داده‌های Blobهای ارسالی می‌باشد.

مستندات دقیق

base64Decode(encoded)

یک رشته کدگذاری شده با مبنای ۶۴ را به یک آرایه بایتی 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 you want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

پارامترها

نام نوع توضیحات
encoded String آرایه‌ای از بایت‌های داده برای رمزگشایی.

بازگشت

Byte[] — داده‌های خام نمایش داده شده توسط آرگومان کدگذاری شده با مبنای ۶۴ به صورت آرایه‌ای از بایت‌ها.

base64Decode(encoded, charset)

یک رشته کدگذاری شده در مبنای ۶۴ را به یک آرایه بایتی در یک مجموعه کاراکتر خاص رمزگشایی می‌کند.

// 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 you 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[] — داده‌های خام نمایش داده شده توسط آرگومان کدگذاری شده با مبنای ۶۴ به صورت آرایه‌ای از بایت‌ها.

base64DecodeWebSafe(encoded)

یک رشته کدگذاری شده تحت وب با استاندارد پایه ۶۴ را به یک آرایه بایتی 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 you want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

پارامترها

نام نوع توضیحات
encoded String آرایه‌ای از بایت‌های داده‌ی امن برای وب که باید رمزگشایی شوند.

بازگشت

Byte[] — داده‌های خام نمایش داده شده توسط آرگومان کدگذاری شده‌ی مبتنی بر وب ۶۴ به صورت آرایه‌ای از بایت‌ها.

base64DecodeWebSafe(encoded, charset)

یک رشته کدگذاری شده تحت وب با مبنای ۶۴ را به یک آرایه بایتی در یک مجموعه کاراکتر خاص رمزگشایی می‌کند.

// 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 you 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[] — داده‌های خام نمایش داده شده توسط آرگومان کدگذاری شده‌ی مبتنی بر وب ۶۴ به صورت آرایه‌ای از بایت‌ها.

base64Encode(data)

یک رشته کدگذاری شده با مبنای ۶۴ را از آرایه بایت داده شده تولید می‌کند. مبنای ۶۴ یک کدگذاری رایج است که توسط ابزارهای مختلفی که نمی‌توانند داده‌های دودویی را بپذیرند، پذیرفته می‌شود. مبنای ۶۴ معمولاً در پروتکل‌های اینترنتی مانند ایمیل، 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[] یک بایت داده برای رمزگذاری.

بازگشت

String - نمایش کدگذاری شده پایه ۶۴ از داده‌های ارسالی.

base64Encode(data)

یک رشته کدگذاری شده با مبنای ۶۴ را از رشته داده شده تولید می‌کند. مبنای ۶۴ یک کدگذاری رایج است که توسط ابزارهای مختلفی که نمی‌توانند داده‌های دودویی را بپذیرند، پذیرفته می‌شود. مبنای ۶۴ معمولاً در پروتکل‌های اینترنتی مانند ایمیل، HTTP یا در اسناد XML استفاده می‌شود.

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

پارامترها

نام نوع توضیحات
data String رشته‌ای که باید کدگذاری شود.

بازگشت

String - نمایش کدگذاری شده پایه ۶۴ از رشته ورودی.

base64Encode(data, charset)

یک رشته کدگذاری شده با مبنای ۶۴ را از رشته داده شده در یک مجموعه کاراکتر خاص تولید می‌کند. مجموعه کاراکتر روشی برای کدگذاری کاراکترها است به طوری که بتوان آنها را کدگذاری کرد. این کاراکترها معمولاً در قالب دودویی انجام می‌شوند که عموماً با پروتکل‌های انتقال داده خاص ناسازگار است. برای سازگاری داده‌ها، آنها معمولاً در مبنای ۶۴ کدگذاری می‌شوند، که یک کدگذاری رایج است که توسط ابزارهای مختلفی که نمی‌توانند داده‌های دودویی را بپذیرند، پذیرفته می‌شود. مبنای ۶۴ معمولاً در پروتکل‌های اینترنتی مانند ایمیل، 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 داده شده.

base64EncodeWebSafe(data)

یک رشته کدگذاری شده مبتنی بر وب ۶۴ بیتی را از آرایه بایت داده شده تولید می‌کند. مبنای ۶۴ یک کدگذاری رایج است که توسط ابزارهای مختلفی که نمی‌توانند داده‌های دودویی را بپذیرند، پذیرفته می‌شود. مبنای ۶۴ مبتنی بر وب معمولاً در پروتکل‌های اینترنتی مانند ایمیل، 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 - نمایش کدگذاری شده‌ی مبتنی بر وبِ ۶۴ بیتی از داده‌های ارسالی.

base64EncodeWebSafe(data)

یک رشته کدگذاری شده مبتنی بر وب ۶۴ بیتی را از رشته داده شده تولید می‌کند. کدگذاری مبتنی بر وب ۶۴ بیتی یک کدگذاری رایج است که توسط ابزارهای مختلفی که نمی‌توانند داده‌های دودویی را بپذیرند، پذیرفته می‌شود. کدگذاری مبتنی بر وب ۶۴ بیتی معمولاً در پروتکل‌های اینترنتی مانند ایمیل، HTTP یا در اسناد XML استفاده می‌شود.

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

پارامترها

نام نوع توضیحات
data String رشته‌ای که باید کدگذاری شود.

بازگشت

String - نمایش رمزگذاری شده مبتنی بر وب ۶۴ بیتی از رشته ورودی.

base64EncodeWebSafe(data, charset)

یک رشته کدگذاری شده مبتنی بر وب ۶۴ بیتی را از رشته داده شده در یک مجموعه کاراکتر خاص تولید می‌کند. مجموعه کاراکتر روشی برای کدگذاری کاراکترها است به طوری که بتوان آنها را کدگذاری کرد. این کاراکترها معمولاً در قالب دودویی انجام می‌شوند که عموماً با پروتکل‌های انتقال داده خاص ناسازگار است. برای سازگاری داده‌ها، آنها معمولاً در قالب پایه ۶۴ کدگذاری می‌شوند، که یک کدگذاری رایج است که توسط ابزارهای مختلفی که نمی‌توانند داده‌های دودویی را بپذیرند، پذیرفته می‌شود. وب ایمن پایه ۶۴ معمولاً در پروتکل‌های اینترنتی مانند ایمیل، 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 - نمایش کدگذاری شده مبتنی بر وب 64 رشته ورودی با Charset داده شده.

compute Digest(algorithm, value)

با استفاده از الگوریتم مشخص شده روی مقدار مشخص شده Byte[] خلاصه‌ای از داده‌ها را محاسبه کنید. 

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

پارامترها

نام نوع توضیحات
algorithm Digest Algorithm یک Digest Algorithm برای استفاده.
value Byte[] یک مقدار رشته‌ای ورودی برای محاسبه خلاصه برای آن.

بازگشت

Byte[] — یک بایت[] که خلاصه خروجی را نشان می‌دهد.

compute Digest(algorithm, value)

با استفاده از الگوریتم مشخص شده روی مقدار String مشخص شده، خلاصه‌ای از آن را محاسبه کنید. 

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

پارامترها

نام نوع توضیحات
algorithm Digest Algorithm یک Digest Algorithm برای استفاده.
value String یک مقدار رشته‌ای ورودی برای محاسبه خلاصه برای آن.

بازگشت

Byte[] — یک بایت[] که خلاصه خروجی را نشان می‌دهد.

compute Digest(algorithm, value, charset)

با استفاده از الگوریتم مشخص شده، خلاصه‌ای از مقدار String مشخص شده با مجموعه کاراکتر داده شده محاسبه کنید. 

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

پارامترها

نام نوع توضیحات
algorithm Digest Algorithm یک Digest Algorithm برای استفاده.
value String یک مقدار رشته‌ای ورودی برای محاسبه خلاصه برای آن.
charset Charset یک Charset که نشان‌دهنده‌ی مجموعه کاراکتر ورودی است.

بازگشت

Byte[] — یک بایت[] که خلاصه خروجی را نشان می‌دهد.

compute Hmac Sha256Signature(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[] — یک بایت[] که امضای خروجی را نشان می‌دهد.

compute Hmac Sha256Signature(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[] — یک بایت[] که امضای خروجی را نشان می‌دهد.

compute Hmac Sha256Signature(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[] — یک بایت[] که امضای خروجی را نشان می‌دهد.

compute Hmac Signature(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 Mac Algorithm یک الگوریتم Mac Algorithm برای استفاده جهت هش کردن مقدار ورودی.
value Byte[] مقدار ورودی برای تولید هش.
key Byte[] کلیدی که برای تولید هش استفاده می‌شود.

بازگشت

Byte[] — یک بایت[] که امضای خروجی را نشان می‌دهد.

compute Hmac Signature(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 Mac Algorithm یک الگوریتم Mac Algorithm برای استفاده جهت هش کردن مقدار ورودی.
value String مقدار ورودی برای تولید هش.
key String کلیدی که برای تولید هش استفاده می‌شود.

بازگشت

Byte[] — یک بایت[] که امضای خروجی را نشان می‌دهد.

compute Hmac Signature(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 Mac Algorithm یک الگوریتم Mac Algorithm برای استفاده جهت هش کردن مقدار ورودی.
value String مقدار ورودی برای تولید هش.
key String کلیدی که برای تولید هش استفاده می‌شود.
charset Charset یک Charset که نشان‌دهنده‌ی مجموعه کاراکتر ورودی است.

بازگشت

Byte[] — یک بایت[] که امضای خروجی را نشان می‌دهد.

compute Rsa Sha1Signature(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[] — یک بایت[] که امضای خروجی را نشان می‌دهد.

compute Rsa Sha1Signature(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[] — یک بایت[] که امضای خروجی را نشان می‌دهد.

compute Rsa Sha256Signature(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[] — یک بایت[] که امضای خروجی را نشان می‌دهد.

compute Rsa Sha256Signature(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[] — یک بایت[] که امضای خروجی را نشان می‌دهد.

compute Rsa Signature(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 Rsa Algorithm یک الگوریتم Rsa Algorithm که برای هش کردن مقدار ورودی استفاده می‌شود.
value String مقدار ورودی برای تولید هش.
key String یک کلید با فرمت PEM که برای تولید امضا استفاده می‌شود.

بازگشت

Byte[] — یک بایت[] که امضای خروجی را نشان می‌دهد.

compute Rsa Signature(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 Rsa Algorithm یک الگوریتم Rsa Algorithm که برای هش کردن مقدار ورودی استفاده می‌شود.
value String مقدار ورودی برای تولید هش.
key String یک کلید با فرمت PEM که برای تولید امضا استفاده می‌شود.
charset Charset یک Charset که نشان‌دهنده‌ی مجموعه کاراکتر ورودی است.

بازگشت

Byte[] — یک بایت[] که امضای خروجی را نشان می‌دهد.

format Date(date, timeZone, format)

تاریخ را طبق مشخصات شرح داده شده در کلاس SimpleDateFormat در Java SE قالب‌بندی می‌کند. لطفاً از مشخصات آن در 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 برای قالب‌بندی به صورت رشته.
time Zone String منطقه زمانی خروجی نتیجه.
format String قالبی مطابق با مشخصات Simple Date Format .

بازگشت

String - تاریخ ورودی به صورت یک رشته قالب‌بندی شده.

format String(template, args)

قالب‌بندی رشته‌ای شبیه به sprintf را با استفاده از رشته‌های قالب‌بندی به سبک '%' انجام می‌دهد. 

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

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

پارامترها

نام نوع توضیحات
template String رشته‌ی قالب‌بندی که کنترل می‌کند چه چیزی برگردانده شود.
args Object... اشیایی که برای پر کردن جاهای خالی '%' در الگو استفاده می‌شوند.

بازگشت

String - رشته قالب‌بندی شده.

get Uuid()

یک 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 Blob Source یک شیء Blob برای فشرده‌سازی با استفاده از gzip .

بازگشت

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 Blob Source یک شیء Blob برای فشرده‌سازی با استفاده از gzip .
name String نام فایل gzip که قرار است ایجاد شود.

بازگشت

Blob — یک Blob جدید حاوی داده‌های فشرده‌شده.

new Blob(data)

یک شیء Blob جدید از یک آرایه بایت ایجاد کنید. Blobها در بسیاری از 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 — بلابِ تازه ایجاد شده.

new Blob(data, contentType)

یک شیء Blob جدید از یک آرایه بایت و نوع محتوا ایجاد کنید. Blobها در بسیاری از 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.
content Type String نوع محتوای blob - می‌تواند null باشد.

بازگشت

Blob — بلابِ تازه ایجاد شده.

new Blob(data, contentType, name)

یک شیء Blob جدید از یک آرایه بایت، نوع محتوا و نام ایجاد کنید. Blobها در بسیاری از 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.
content Type String - نوع محتوای blob می‌تواند null باشد.
name String نام blob - می‌تواند null باشد.

بازگشت

Blob — بلابِ تازه ایجاد شده.

new Blob(data)

ایجاد یک شیء Blob جدید از یک رشته. Blobها در بسیاری از 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 رشته مربوط به blob، با فرض UTF-8.

بازگشت

Blob — بلابِ تازه ایجاد شده.

new Blob(data, contentType)

یک شیء Blob جدید از یک رشته و نوع محتوا ایجاد کنید. Blobها در بسیاری از 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 رشته مربوط به blob، با فرض UTF-8.
content Type String نوع محتوای blob - می‌تواند null باشد.

بازگشت

Blob — بلابِ تازه ایجاد شده.

new Blob(data, contentType, name)

یک شیء Blob جدید از یک رشته، نوع محتوا و نام ایجاد کنید. Blobها در بسیاری از 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 رشته مربوط به blob، با فرض UTF-8.
content Type String نوع محتوای blob - می‌تواند null باشد.
name String نام blob - می‌تواند null باشد.

بازگشت

Blob — بلابِ تازه ایجاد شده.

parse Csv(csv)

یک آرایه دوبعدی جدولی از یک رشته CSV را برمی‌گرداند. 

// 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.

parse Csv(csv, delimiter)

یک آرایه دوبعدی جدولی از یک رشته CSV را با استفاده از یک جداکننده سفارشی برمی‌گرداند. 

// 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.

parse Date(date, timeZone, format)

رشته‌ی تاریخ ارائه شده را طبق مشخصات شرح داده شده در کلاس Simple Date Format ویرایش استاندارد جاوا تجزیه می‌کند. برای اطلاعات بیشتر، به کلاس Simple Date Format جاوا مراجعه کنید. 

// 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 یک مقدار رشته‌ای برای تجزیه به عنوان تاریخ.
time Zone String منطقه زمانی خروجی
format String قالب تاریخ طبق مشخصات Simple Date Format .

بازگشت

Date — رشته ورودی به عنوان تاریخ.

sleep(milliseconds)

به مدت زمان مشخصی (بر حسب میلی‌ثانیه) به حالت خواب می‌رود. بلافاصله اسکریپت را به مدت زمان مشخصی (بر حسب میلی‌ثانیه) به حالت خواب می‌برد. حداکثر مقدار مجاز ۳۰۰۰۰۰ (یا ۵ دقیقه) است. 

// 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 Blob Source Blob داده‌های فشرده‌شده.

بازگشت

Blob — یک Blob که نشان‌دهنده‌ی داده‌های از حالت فشرده خارج شده است.

unzip(blob)

یک 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 Blob Source حباب فایل زیپ.

بازگشت

Blob[] — یک Blob[] که نمایانگر blobهای کامپوننت است و هر کدام با مسیر کامل درون zip نامگذاری شده‌اند.

zip(blobs)

یک شیء Blob جدید ایجاد می‌کند که یک فایل زیپ است و حاوی داده‌های 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 Blob Source[] مجموعه‌ای از حباب‌ها برای بستن زیپ.

بازگشت

Blob — یک blob جدید که شامل ورودی‌ها به عنوان آرشیو است.

zip(blobs, name)

یک شیء Blob جدید ایجاد می‌کند که یک فایل زیپ است و حاوی داده‌های 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 Blob Source[] مجموعه‌ای از حباب‌ها برای بستن زیپ.
name String نام فایل زیپی که قرار است ایجاد شود.

بازگشت

Blob — یک blob جدید که شامل ورودی‌ها به عنوان آرشیو است.

متدهای منسوخ شده