Class Utilities

آب و برق

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

خواص

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

روش ها

روش نوع برگشت شرح مختصر
base64Decode(encoded) Byte[] یک رشته رمزگذاری شده پایه 64 را در یک آرایه بایتی UTF-8 رمزگشایی می کند.
base64Decode(encoded, charset) Byte[] یک رشته رمزگذاری شده پایه 64 را در یک آرایه بایت در یک مجموعه کاراکتر خاص رمزگشایی می کند.
base64DecodeWebSafe(encoded) Byte[] یک رشته رمزگذاری شده مبتنی بر وب بیس 64 را در یک آرایه بایتی UTF-8 رمزگشایی می کند.
base64DecodeWebSafe(encoded, charset) Byte[] یک رشته رمزگذاری شده مبتنی بر وب 64 را در یک آرایه بایت در یک مجموعه کاراکتر خاص رمزگشایی می کند.
base64Encode(data) String از آرایه بایت داده شده یک رشته کدگذاری شده با پایه 64 ایجاد می کند.
base64Encode(data) String از رشته داده شده یک رشته رمزگذاری شده با پایه 64 تولید می کند.
base64Encode(data, charset) String یک رشته کدگذاری شده پایه 64 از رشته داده شده در یک مجموعه کاراکتر خاص ایجاد می کند.
base64EncodeWebSafe(data) String از آرایه بایت داده شده، یک رشته رمزگذاری شده مبتنی بر وب بیس 64 ایجاد می کند.
base64EncodeWebSafe(data) String یک رشته رمزگذاری شده مبتنی بر وب بیس 64 از رشته داده شده ایجاد می کند.
base64EncodeWebSafe(data, charset) String یک رشته کدگذاری شده مبتنی بر وب بیس 64 از رشته داده شده در یک مجموعه کاراکتر خاص ایجاد می کند.
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 تاریخ فرمت ها مطابق با مشخصات توصیف شده در کلاس Java SE SimpleDateFormat است.
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 جدید ایجاد می کند که یک فایل فشرده حاوی داده های Blobs ارسال شده است.
zip(blobs, name) Blob یک شی Blob جدید ایجاد می کند که یک فایل فشرده حاوی داده های Blobs ارسال شده است.

مستندات دقیق

base64Decode(encoded)

یک رشته رمزگذاری شده پایه 64 را در یک آرایه بایتی 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[] - داده خام که توسط آرگومان کدگذاری شده base-64 به عنوان یک آرایه بایت نمایش داده می شود.

base64Decode(encoded, charset)

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

// 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[] - داده خام که توسط آرگومان کدگذاری شده base-64 به عنوان یک آرایه بایت نمایش داده می شود.

base64DecodeWebSafe(encoded)

یک رشته رمزگذاری شده مبتنی بر وب بیس 64 را در یک آرایه بایتی 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[] - داده خام که توسط آرگومان رمزگذاری شده وب ایمن base-64 به عنوان یک آرایه بایت نشان داده می شود.

base64DecodeWebSafe(encoded, charset)

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

// 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[] - داده خام که توسط آرگومان رمزگذاری شده وب ایمن base-64 به عنوان یک آرایه بایت نشان داده می شود.

base64Encode(data)

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

base64Encode(data)

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

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

پارامترها

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

بازگشت

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

base64Encode(data, charset)

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

base64EncodeWebSafe(data)

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

base64EncodeWebSafe(data)

یک رشته رمزگذاری شده مبتنی بر وب بیس 64 از رشته داده شده ایجاد می کند. پایه 64 یک رمزگذاری رایج است که توسط ابزارهای مختلفی پذیرفته شده است که نمی توانند داده های باینری را بپذیرند. Base 64 web-safe معمولاً در پروتکل های اینترنتی مانند ایمیل، HTTP یا در اسناد XML استفاده می شود. 

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

پارامترها

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

بازگشت

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

base64EncodeWebSafe(data, charset)

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

تاریخ فرمت ها مطابق با مشخصات توصیف شده در کلاس 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 برای قالب بندی به عنوان یک رشته.
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 جدید از یک آرایه بایت ایجاد کنید. Blobs در بسیاری از API های Apps Script استفاده می شود که داده های باینری را به عنوان ورودی می گیرند. 

// 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 جدید از یک آرایه بایت و نوع محتوا ایجاد کنید. Blobs در بسیاری از API های Apps Script استفاده می شود که داده های باینری را به عنوان ورودی می گیرند. 

// 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[] بایت برای لکه.
content Type String نوع محتوای حباب - می تواند null باشد.

بازگشت

Blob - Blob تازه ایجاد شده.

new Blob(data, contentType, name)

یک شی Blob جدید از یک آرایه بایت، نوع محتوا و نام ایجاد کنید. Blobs در بسیاری از API های Apps Script استفاده می شود که داده های باینری را به عنوان ورودی می گیرند. 

// 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[] بایت برای لکه.
content Type String - نوع محتوای حباب - می تواند null باشد.
name String نام لکه - می تواند null باشد.

بازگشت

Blob - Blob تازه ایجاد شده.

new Blob(data)

یک شی Blob جدید از یک رشته ایجاد کنید. Blobs در بسیاری از API های Apps Script استفاده می شود که داده های باینری را به عنوان ورودی می گیرند. 

// 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 تازه ایجاد شده.

new Blob(data, contentType)

یک شی Blob جدید از رشته و نوع محتوا ایجاد کنید. Blobs در بسیاری از API های Apps Script استفاده می شود که داده های باینری را به عنوان ورودی می گیرند. 

// 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 فرض شده است.
content Type String نوع محتوای حباب - می تواند null باشد.

بازگشت

Blob - Blob تازه ایجاد شده.

new Blob(data, contentType, name)

یک شی Blob جدید از رشته، نوع محتوا و نام ایجاد کنید. Blobs در بسیاری از API های Apps Script استفاده می شود که داده های باینری را به عنوان ورودی می گیرند. 

// 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 فرض شده است.
content Type String نوع محتوای حباب - می تواند null باشد.
name String نام لکه - می تواند null باشد.

بازگشت

Blob - 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)

برای تعداد میلی ثانیه مشخص می خوابد. بلافاصله اسکریپت را برای تعداد میلی ثانیه مشخص شده در حالت خواب قرار می دهد. حداکثر مقدار مجاز 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 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[] که نشان دهنده حباب های مؤلفه است که هر کدام با مسیر کامل در داخل zip نامگذاری شده اند.

zip(blobs)

یک شی Blob جدید ایجاد می کند که یک فایل فشرده حاوی داده های Blobs ارسال شده است. 

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 - یک حباب جدید حاوی ورودی ها به عنوان یک بایگانی.

zip(blobs, name)

یک شی Blob جدید ایجاد می کند که یک فایل فشرده حاوی داده های Blobs ارسال شده است. این نسخه از روش اجازه می دهد تا یک نام فایل مشخص شود. 

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 - یک حباب جدید حاوی ورودی ها به عنوان یک بایگانی.

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