این سرویس ابزارهایی را برای رمزگذاری/رمزگشایی رشته، قالب بندی تاریخ، دستکاری 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 . |
بازگشت
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 که باید ایجاد شود. |
بازگشت
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 داده های فشرده |
بازگشت
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
- یک حباب جدید حاوی ورودی ها به عنوان یک بایگانی.