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

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