Class Utilities

خدمات رفاهی

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

خواص

ویژگی تایپ کنید شرح
Charset Charset
DigestAlgorithm DigestAlgorithm
MacAlgorithm MacAlgorithm
RsaAlgorithm RsaAlgorithm

مواد و روش ها

روش نوع برگشت توضیح مختصر
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 از رشته داده شده در یک مجموعه کاراکتر خاص ایجاد می کند.
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 را برمی گرداند.
parseCsv(csv, delimiter) String[][] یک نمایش آرایه دو بعدی جدولی از یک رشته CSV را با استفاده از یک جداکننده سفارشی برمی‌گرداند.
parseDate(date, timeZone, format) Date تاریخ رشته ارائه شده را طبق مشخصات توصیف شده در کلاس Java Standard Edition SimpleDateFormat تجزیه می کند.
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 グループ"
var base64data = "R29vZ2xlIOOCsOODq+ODvOODlw==";

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
var 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 グループ"
var base64data = "R29vZ2xlIOOCsOODq+ODvOODlw==";

var 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 グループ"
var base64data = "R29vZ2xlIOOCsOODq-ODvOODlw==";

var 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 グループ"
var base64data = "R29vZ2xlIOOCsOODq-ODvOODlw==";

var 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
var blob = Utilities.newBlob("A string here");

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

مولفه های

نام تایپ کنید شرح
data Byte[] یک بایت [] داده برای رمزگذاری.

برگشت

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

base64Encode(data)

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

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
var 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)
var input = "Google グループ";

// Writes "R29vZ2xlIOOCsOODq+ODvOODlw==" to the log
var 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
var blob = Utilities.newBlob("A string here");

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
var 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.
var 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)
var input = "Google グループ";

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

مولفه های

نام تایپ کنید شرح
data String رشته ای از داده ها برای رمزگذاری
charset Charset Charset که مجموعه نویسه ورودی را مشخص می کند.

برگشت

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

computeDigest(algorithm, value)

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

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

مولفه های

نام تایپ کنید شرح
algorithm DigestAlgorithm یک DigestAlgorithm برای استفاده
value Byte[] یک مقدار رشته ورودی برای محاسبه خلاصه.

برگشت

Byte[] - یک بایت[] که نمایانگر خلاصه خروجی است.

computeDigest(algorithm, value)

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

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

مولفه های

نام تایپ کنید شرح
algorithm DigestAlgorithm یک DigestAlgorithm برای استفاده
value String یک مقدار رشته ورودی برای محاسبه خلاصه.

برگشت

Byte[] - یک بایت[] که نمایانگر خلاصه خروجی است.

computeDigest(algorithm, value, charset)

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

var 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[] - یک بایت[] که نمایانگر خلاصه خروجی است.

computeHmacSha256Signature(value, key)

مقدار ارائه شده را با استفاده از HMAC-SHA256 با کلید داده شده امضا می کند.

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

مولفه های

نام تایپ کنید شرح
value Byte[] مقدار ورودی برای ایجاد هش برای.
key Byte[] کلیدی برای تولید هش با استفاده از آن.

برگشت

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

computeHmacSha256Signature(value, key)

مقدار ارائه شده را با استفاده از HMAC-SHA256 با کلید داده شده امضا می کند.

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

مولفه های

نام تایپ کنید شرح
value String مقدار ورودی برای ایجاد هش برای.
key String کلیدی برای تولید هش با استفاده از آن.

برگشت

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

computeHmacSha256Signature(value, key, charset)

مقدار ارائه شده را با استفاده از HMAC-SHA256 با کلید و مجموعه کاراکتر داده شده امضا می کند.

// This writes an array of bytes to the log.
var 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[] - یک بایت[] که نشان دهنده امضای خروجی است.

computeHmacSignature(algorithm, value, key)

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

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

مولفه های

نام تایپ کنید شرح
algorithm MacAlgorithm یک الگوریتم MacAlgorithm برای هش کردن مقدار ورودی.
value Byte[] مقدار ورودی برای ایجاد هش برای.
key Byte[] کلیدی برای تولید هش با استفاده از آن.

برگشت

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

computeHmacSignature(algorithm, value, key)

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

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

مولفه های

نام تایپ کنید شرح
algorithm MacAlgorithm یک الگوریتم MacAlgorithm برای هش کردن مقدار ورودی.
value String مقدار ورودی برای ایجاد هش برای.
key String کلیدی برای تولید هش با استفاده از آن.

برگشت

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

computeHmacSignature(algorithm, value, key, charset)

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

// This writes an array of bytes to the log.
var 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[] - یک بایت[] که نشان دهنده امضای خروجی است.

computeRsaSha1Signature(value, key)

مقدار ارائه شده را با استفاده از RSA-SHA1 با کلید داده شده امضا می کند.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha1Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

مولفه های

نام تایپ کنید شرح
value String مقدار ورودی برای ایجاد هش برای.
key String یک کلید قالب بندی شده PEM برای استفاده برای تولید امضا.

برگشت

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

computeRsaSha1Signature(value, key, charset)

مقدار ارائه شده را با استفاده از RSA-SHA1 با کلید و مجموعه نویسه داده شده امضا می کند.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha1Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n"
    Utilities.Charset.US_ASCII);
Logger.log(signature);

مولفه های

نام تایپ کنید شرح
value String مقدار ورودی برای ایجاد هش برای.
key String یک کلید قالب بندی شده PEM برای استفاده برای تولید امضا.
charset Charset Charset که مجموعه کاراکترهای ورودی را نشان می دهد.

برگشت

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

computeRsaSha256Signature(value, key)

مقدار ارائه شده را با استفاده از RSA-SHA256 با کلید داده شده امضا می کند.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha256Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

مولفه های

نام تایپ کنید شرح
value String مقدار ورودی برای ایجاد هش برای.
key String یک کلید قالب بندی شده PEM برای استفاده برای تولید امضا.

برگشت

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

computeRsaSha256Signature(value, key, charset)

مقدار ارائه شده را با استفاده از RSA-SHA256 با کلید داده شده امضا می کند.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha256Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

مولفه های

نام تایپ کنید شرح
value String مقدار ورودی برای ایجاد هش برای.
key String یک کلید قالب بندی شده PEM برای استفاده برای تولید امضا.
charset Charset Charset که مجموعه کاراکترهای ورودی را نشان می دهد.

برگشت

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

computeRsaSignature(algorithm, value, key)

مقدار ارائه شده را با استفاده از الگوریتم RSA مشخص شده با کلید داده شده امضا می کند.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSignature(Utilities.RsaAlgorithm.RSA_SHA_256,
    "this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

مولفه های

نام تایپ کنید شرح
algorithm RsaAlgorithm یک الگوریتم RsaAlgorithm برای هش کردن مقدار ورودی.
value String مقدار ورودی برای ایجاد هش برای.
key String یک کلید قالب بندی شده PEM برای استفاده برای تولید امضا.

برگشت

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

computeRsaSignature(algorithm, value, key, charset)

مقدار ارائه شده را با استفاده از الگوریتم RSA مشخص شده با کلید و مجموعه نویسه داده شده امضا می کند.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSignature(Utilities.RsaAlgorithm.RSA_SHA_256,
    "this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n",
    Utilities.Charset.US_ASCII);
Logger.log(signature);

مولفه های

نام تایپ کنید شرح
algorithm RsaAlgorithm یک الگوریتم RsaAlgorithm برای هش کردن مقدار ورودی.
value String مقدار ورودی برای ایجاد هش برای.
key String یک کلید قالب بندی شده PEM برای استفاده برای تولید امضا.
charset Charset Charset که مجموعه کاراکترهای ورودی را نشان می دهد.

برگشت

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.
var 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.
var myDataObject = {
   tempId: Utilities.getUuid();
};

برگشت

String - نمایش رشته ای از UUID.

gzip(blob)

gzip - داده های Blob ارائه شده را فشرده می کند و آن را در یک شی Blob جدید برمی گرداند.

var textBlob = Utilities.newBlob("Some text to compress using gzip compression");

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

مولفه های

نام تایپ کنید شرح
blob BlobSource یک شی Blob برای فشرده سازی با استفاده از gzip .

برگشت

Blob - یک Blob جدید حاوی داده های فشرده شده است.

gzip(blob, name)

gzip - داده های Blob ارائه شده را فشرده می کند و آن را در یک شی Blob جدید برمی گرداند. این نسخه از روش اجازه می دهد تا یک نام فایل مشخص شود.

var textBlob = Utilities.newBlob("Some text to compress using gzip compression");

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

مولفه های

نام تایپ کنید شرح
blob BlobSource یک شی Blob برای فشرده سازی با استفاده از gzip .
name String نام فایل gzip که باید ایجاد شود.

برگشت

Blob - یک Blob جدید حاوی داده های فشرده شده است.

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

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

برگشت

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

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

برگشت

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

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

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

برگشت

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

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

برگشت

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

parseCsv(csv)

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

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

مولفه های

نام تایپ کنید شرح
csv String رشته ای حاوی داده های تک یا چند خطی در قالب مقدار جدا شده با کاما (CSV).

برگشت

String[][] - یک آرایه دو بعدی حاوی مقادیر موجود در رشته CSV.

parseCsv(csv, delimiter)

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

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

مولفه های

نام تایپ کنید شرح
csv String رشته ای حاوی داده های تک یا چند خطی در قالب مقدار جدا شده با کاما (CSV).
delimiter Char بین ارزش ها

برگشت

String[][] - یک آرایه دو بعدی حاوی مقادیر موجود در رشته CSV.

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.
var 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 حاوی داده های فشرده نشده را برمی گرداند.

var textBlob = Utilities.newBlob("Some text to compress using gzip compression");

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

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

مولفه های

نام تایپ کنید شرح
blob BlobSource Blob داده های فشرده

برگشت

Blob - Blob که داده های فشرده شده را نشان می دهد.

unzip(blob)

یک Blob که یک فایل فشرده را نشان می دهد می گیرد و فایل های جزء آن را برمی گرداند.

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

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

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

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

مولفه های

نام تایپ کنید شرح
blob BlobSource حباب فایل زیپ.

برگشت

Blob[] - یک Blob[] که نشان دهنده حباب های مؤلفه است که هر کدام با مسیر کامل در داخل zip نامگذاری شده اند.

zip(blobs)

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

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

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

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

مولفه های

نام تایپ کنید شرح
blobs BlobSource[] آرایه ای از حباب ها برای فشرده سازی.

برگشت

Blob - یک حباب جدید حاوی ورودی ها به عنوان یک بایگانی.

zip(blobs, name)

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

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

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

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

مولفه های

نام تایپ کنید شرح
blobs BlobSource[] آرایه ای از حباب ها برای فشرده سازی.
name String نام فایل فشرده ای که قرار است ایجاد شود.

برگشت

Blob - یک حباب جدید حاوی ورودی ها به عنوان یک بایگانی.

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