Class Utilities

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
برامج الخدمات

وتوفّر هذه الخدمة برامج مساعدة لترميز/فك ترميز السلاسل وتنسيق التاريخ ومعالجة JSON وغيرها من المهام المتنوّعة.

أماكن إقامة

الخاصيةالنوعالوصف
CharsetCharset
DigestAlgorithmDigestAlgorithm
MacAlgorithmMacAlgorithm
RsaAlgorithmRsaAlgorithm

الطُرق

الطريقةنوع الإرجاعوصف قصير
base64Decode(encoded)Byte[]فك ترميز سلسلة base-64 المشفّرة إلى مصفوفة UTF-8
base64Decode(encoded, charset)Byte[]فك ترميز سلسلة base-64 المشفّرة في مصفوفة بايت في مجموعة أحرف معيّنة.
base64DecodeWebSafe(encoded)Byte[]لفك ترميز السلسلة المشفّرة بتشفير base-64 على الويب في مصفوفة UTF-8 بايت.
base64DecodeWebSafe(encoded, charset)Byte[]لفك ترميز سلسلة مشفّرة آمنة على الويب بمعيار 64 إلى مصفوفة بايت في مجموعة أحرف معيّنة.
base64Encode(data)Stringتنشئ سلسلة مشفّرة base-64 من مصفوفة بايت معينة.
base64Encode(data)Stringتنشئ سلسلة مشفّرة base-64 من السلسلة المعنية.
base64Encode(data, charset)Stringتنشئ سلسلة مشفّرة Base-64 من السلسلة المحددة في مجموعة أحرف محددة.
base64EncodeWebSafe(data)Stringتنشئ سلسلة مشفّرة على الويب بمعيار base-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 SimpleDateFormat.
sleep(milliseconds)voidمرات السكون لعدد محدد من المللي ثانية.
ungzip(blob)Blobيتم فك ضغط عنصر Blob وعرض Blob الذي يحتوي على البيانات غير المضغوطة.
unzip(blob)Blob[]تأخذ Blob رمزًا لملف ZIP ويعرض ملفاته المكوّنة.
zip(blobs)Blobإنشاء كائن Blob جديد يكون عبارة عن ملف ZIP يحتوي على بيانات من Blobs التي تم تمريرها.
zip(blobs, name)Blobإنشاء كائن Blob جديد يكون عبارة عن ملف ZIP يحتوي على بيانات من Blobs التي تم تمريرها.

المستندات التفصيلية

base64Decode(encoded)

فك ترميز سلسلة base-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());

المَعلمات

الاسمالنوعالوصف
encodedStringمصفوفة من بايت من البيانات لفك الترميز

تذكرة ذهاب وعودة

Byte[] - البيانات الأولية التي تمثلها وسيطة base-64 المشفّرة كمصفوفة بايت


base64Decode(encoded, charset)

فك ترميز سلسلة base-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());

المَعلمات

الاسمالنوعالوصف
encodedStringسلسلة البيانات لفك الترميز
charsetCharsetعلامة Charset تحدد حرف الإدخال.

تذكرة ذهاب وعودة

Byte[] - البيانات الأولية التي تمثلها وسيطة base-64 المشفّرة كمصفوفة بايت


base64DecodeWebSafe(encoded)

لفك ترميز السلسلة المشفّرة بتشفير base-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());

المَعلمات

الاسمالنوعالوصف
encodedStringمصفوفة من بايت من البيانات الآمنة على الويب لفك الترميز

تذكرة ذهاب وعودة

Byte[]: البيانات الأولية التي تمثّلها الوسيطة المشفّرة الآمنة على الويب بمعيار 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());

المَعلمات

الاسمالنوعالوصف
encodedStringسلسلة البيانات الآمنة على الويب لفك الترميز
charsetCharsetعلامة Charset تحدد حرف الإدخال.

تذكرة ذهاب وعودة

Byte[]: البيانات الأولية التي تمثّلها الوسيطة المشفّرة الآمنة على الويب بمعيار 64 كمصفوفة بايت


base64Encode(data)

تنشئ سلسلة مشفّرة base-64 من مصفوفة بايت معينة. Base 64 هو ترميز شائع تقبله مجموعة متنوعة من الأدوات التي لا يمكنها قبول البيانات الثنائية. يُستخدَم Base 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);

المَعلمات

الاسمالنوعالوصف
dataByte[]بايت[] من البيانات للتشفير

تذكرة ذهاب وعودة

String — تمثيل 64 الأساسي للترميز في البيانات


base64Encode(data)

تنشئ سلسلة مشفّرة base-64 من السلسلة المعنية. Base 64 هو ترميز شائع مقبول من خلال مجموعة متنوعة من الأدوات التي لا يمكنها قبول البيانات الثنائية. تُستخدَم Base 64 عادةً في بروتوكولات الإنترنت، مثل البريد الإلكتروني أو HTTP أو في مستندات XML.

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

المَعلمات

الاسمالنوعالوصف
dataStringالسلسلة المطلوب ترميزها

تذكرة ذهاب وعودة

String: تمثيل 64 المشفر لسلسلة الإدخال


base64Encode(data, charset)

تنشئ سلسلة مشفّرة Base-64 من السلسلة المحددة في مجموعة أحرف محددة. مجموعة الأحرف هي طريقة لترميز الأحرف بحيث يمكن تشفيرها. ويتم تنفيذ هذه الإجراءات عادةً بتنسيق ثنائي، يمكن أن يكون غير متوافق بشكل عام مع بروتوكولات معيّنة لنقل البيانات. ولجعل البيانات متوافقة، يتم تشفيرها بشكل عام في القاعدة 64، وهي ترميز شائع تقبله مجموعة متنوعة من الأدوات التي لا يمكنها قبول البيانات الثنائية. يُستخدَم Base 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);

المَعلمات

الاسمالنوعالوصف
dataStringسلسلة البيانات المطلوب ترميزها
charsetCharsetعلامة Charset تحدد حرف الإدخال.

تذكرة ذهاب وعودة

String: تمثيل 64 المشفر لسلسلة الإدخال باستخدام Charset المحدَّد


base64EncodeWebSafe(data)

تنشئ سلسلة مشفّرة على الويب بمعيار base-64 من مصفوفة بايت معيّنة. Base 64 هو ترميز شائع يتم قبوله من خلال مجموعة من الأدوات التي لا يمكنها قبول البيانات الثنائية. وتُستخدَم تقنية Base 64 الآمنة على الويب عادةً في بروتوكولات الإنترنت، مثل البريد الإلكتروني أو 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);

المَعلمات

الاسمالنوعالوصف
dataByte[]مصفوفة من بايت من البيانات لترميزها

تذكرة ذهاب وعودة

String: تمثيل البيانات المشفّر بتشفير base-64 للبيانات التي تم تمريرها في البيانات


base64EncodeWebSafe(data)

تنشئ السلسلة سلسلة مشفّرة ومتوافقة مع الويب رقم 64 من السلسلة المحدّدة. Base 64 هو ترميز شائع تقبله مجموعة متنوعة من الأدوات التي لا يمكنها قبول البيانات الثنائية. تُستخدَم تقنية Base 64 الآمنة على الويب عادةً في بروتوكولات الإنترنت، مثل البريد الإلكتروني أو HTTP أو مستندات XML.

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

المَعلمات

الاسمالنوعالوصف
dataStringالسلسلة المطلوب ترميزها

تذكرة ذهاب وعودة

String — تمثيل 64 المشفر على الويب المستند إلى الويب لسلسلة الإدخال


base64EncodeWebSafe(data, charset)

تنشئ سلسلة 64 مشفّرة على الويب آمنة من السلسلة المحدّدة في مجموعة أحرف معيّنة. مجموعة الأحرف هي طريقة لترميز الأحرف بحيث يمكن تشفيرها. ويتم تنفيذ هذه الإجراءات عادةً بتنسيق ثنائي والتي قد تكون غير متوافقة عمومًا مع بروتوكولات معيّنة لنقل البيانات. ولجعل البيانات متوافقة، يتم تشفيرها بشكل عام في الأساس 64، وهو ترميز شائع تقبله مجموعة متنوعة من الأدوات التي لا يمكنها قبول البيانات الثنائية. تُستخدَم قاعدة الأمان 64 الآمنة على الويب عادةً في بروتوكولات الإنترنت، مثل البريد الإلكتروني أو 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);

المَعلمات

الاسمالنوعالوصف
dataStringسلسلة البيانات المطلوب ترميزها
charsetCharsetعلامة 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);

المَعلمات

الاسمالنوعالوصف
algorithmDigestAlgorithmDigestAlgorithm للاستخدام
valueByte[]قيمة سلسلة إدخال لحساب الملخّص من أجل

تذكرة ذهاب وعودة

Byte[] — بايت[] تمثّل سلسلة الإخراج


computeDigest(algorithm, value)

احسب الملخّص باستخدام الخوارزمية المحدّدة على قيمة String المحدّدة.

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

المَعلمات

الاسمالنوعالوصف
algorithmDigestAlgorithmDigestAlgorithm للاستخدام
valueStringقيمة سلسلة إدخال لحساب الملخّص من أجل

تذكرة ذهاب وعودة

Byte[] — بايت[] تمثّل سلسلة الإخراج


computeDigest(algorithm, value, charset)

احسب الملخّص باستخدام الخوارزمية المحدّدة على قيمة String المحدّدة مع مجموعة الأحرف المحددة.

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

المَعلمات

الاسمالنوعالوصف
algorithmDigestAlgorithmDigestAlgorithm للاستخدام
valueStringقيمة سلسلة إدخال لحساب الملخّص من أجل
charsetCharsetCharset التي تمثل مجموعة أحرف الإدخال

تذكرة ذهاب وعودة

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

المَعلمات

الاسمالنوعالوصف
valueByte[]قيمة الإدخال لإنشاء تجزئة
keyByte[]مفتاح يمكن استخدامه لإنشاء التجزئة باستخدام

تذكرة ذهاب وعودة

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

المَعلمات

الاسمالنوعالوصف
valueStringقيمة الإدخال لإنشاء تجزئة
keyStringمفتاح يمكن استخدامه لإنشاء التجزئة باستخدام

تذكرة ذهاب وعودة

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

المَعلمات

الاسمالنوعالوصف
valueStringقيمة الإدخال لإنشاء تجزئة
keyStringمفتاح يمكن استخدامه لإنشاء التجزئة باستخدام
charsetCharsetCharset التي تمثل مجموعة أحرف الإدخال

تذكرة ذهاب وعودة

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

المَعلمات

الاسمالنوعالوصف
algorithmMacAlgorithmخوارزمية MacAlgorithm لاستخدامها لتجزئة قيمة الإدخال
valueByte[]قيمة الإدخال لإنشاء تجزئة
keyByte[]مفتاح يمكن استخدامه لإنشاء التجزئة باستخدام

تذكرة ذهاب وعودة

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

المَعلمات

الاسمالنوعالوصف
algorithmMacAlgorithmخوارزمية MacAlgorithm لاستخدامها لتجزئة قيمة الإدخال
valueStringقيمة الإدخال لإنشاء تجزئة
keyStringمفتاح يمكن استخدامه لإنشاء التجزئة باستخدام

تذكرة ذهاب وعودة

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

المَعلمات

الاسمالنوعالوصف
algorithmMacAlgorithmخوارزمية MacAlgorithm لاستخدامها لتجزئة قيمة الإدخال
valueStringقيمة الإدخال لإنشاء تجزئة
keyStringمفتاح يمكن استخدامه لإنشاء التجزئة باستخدام
charsetCharsetCharset التي تمثل مجموعة أحرف الإدخال

تذكرة ذهاب وعودة

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

المَعلمات

الاسمالنوعالوصف
valueStringقيمة الإدخال لإنشاء تجزئة لها.
keyStringمفتاح 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);

المَعلمات

الاسمالنوعالوصف
valueStringقيمة الإدخال لإنشاء تجزئة لها.
keyStringمفتاح PEM بتنسيق لإنشاء التوقيع.
charsetCharsetتمثّل 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);

المَعلمات

الاسمالنوعالوصف
valueStringقيمة الإدخال لإنشاء تجزئة
keyStringمفتاح بتنسيق 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);

المَعلمات

الاسمالنوعالوصف
valueStringقيمة الإدخال لإنشاء تجزئة
keyStringمفتاح بتنسيق PEM لاستخدامه لإنشاء التوقيع
charsetCharsetCharset التي تمثل مجموعة أحرف الإدخال

تذكرة ذهاب وعودة

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

المَعلمات

الاسمالنوعالوصف
algorithmRsaAlgorithmخوارزمية RsaAlgorithm لاستخدامها لتجزئة قيمة الإدخال.
valueStringقيمة الإدخال لإنشاء تجزئة لها.
keyStringمفتاح 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);

المَعلمات

الاسمالنوعالوصف
algorithmRsaAlgorithmخوارزمية RsaAlgorithm لاستخدامها لتجزئة قيمة الإدخال.
valueStringقيمة الإدخال لإنشاء تجزئة لها.
keyStringمفتاح PEM بتنسيق لإنشاء التوقيع.
charsetCharsetتمثّل 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);

المَعلمات

الاسمالنوعالوصف
dateDateDate للتنسيق كسلسلة
timeZoneStringالمنطقة الزمنية لإخراج النتيجة
formatStringتنسيق وفقًا لمواصفات SimpleDateFormat

تذكرة ذهاب وعودة

String - تاريخ الإدخال كسلسلة منسَّقة


formatString(template, args)

يؤدي إلى تنسيق سلسلة بشكل يشبه sprintf باستخدام سلاسل التنسيق بنمط '%'-.

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

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

المَعلمات

الاسمالنوعالوصف
templateStringسلسلة التنسيق التي تتحكّم في ما يتم عرضه.
argsObject...الكائنات المطلوب استخدامها لملء العناصر النائبة في النموذج '%'

تذكرة ذهاب وعودة

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

المَعلمات

الاسمالنوعالوصف
blobBlobSourceعنصر 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");

المَعلمات

الاسمالنوعالوصف
blobBlobSourceعنصر Blob لضغطه باستخدام gzip.
nameStringاسم ملف gzip الذي سيتم إنشاؤه

تذكرة ذهاب وعودة

Blob: أداة جديدة Blob تحتوي على البيانات المضغوطة.


newBlob(data)

يمكنك إنشاء كائن Blob جديد من مصفوفة بايت. يتم استخدام الكائنات الثنائية الكبيرة في العديد من واجهات برمجة التطبيقات لبرمجة التطبيقات التي تستخدم البيانات الثنائية كإدخال.

المَعلمات

الاسمالنوعالوصف
dataByte[]وحدات البايت للكائن الثنائي الكبير (blob)

تذكرة ذهاب وعودة

Blob: Blob الذي تم إنشاؤه حديثًا


newBlob(data, contentType)

إنشاء كائن Blob جديد من مصفوفة وحدات البايت ونوع المحتوى. تُستخدم الكائنات الثنائية الكبيرة في العديد من واجهات برمجة التطبيقات لبرمجة التطبيقات التي تستخدم البيانات الثنائية كإدخال.

المَعلمات

الاسمالنوعالوصف
dataByte[]وحدات البايت للكائن الثنائي الكبير (blob)
contentTypeStringنوع المحتوى كائن ثنائي كبير (blob) - يمكن أن يكون فارغًا

تذكرة ذهاب وعودة

Blob: Blob الذي تم إنشاؤه حديثًا


newBlob(data, contentType, name)

يمكنك إنشاء كائن Blob جديد من مصفوفة وحدات البايت ونوع المحتوى واسمه. يتم استخدام الكائنات الثنائية الكبيرة في العديد من واجهات برمجة التطبيقات لبرمجة التطبيقات التي تستخدم البيانات الثنائية كإدخال.

المَعلمات

الاسمالنوعالوصف
dataByte[]وحدات البايت للكائن الثنائي الكبير (blob)
contentTypeString- نوع كائن الكائن الثنائي الكبير (blob) - يمكن أن يكون فارغًا
nameStringاسم الكائن الثنائي الكبير (blob) - يمكن أن يكون فارغًا

تذكرة ذهاب وعودة

Blob: Blob الذي تم إنشاؤه حديثًا


newBlob(data)

إنشاء كائن Blob جديد من سلسلة. يتم استخدام الكائنات الثنائية الكبيرة في العديد من واجهات برمجة التطبيقات لبرمجة التطبيقات التي تستخدم البيانات الثنائية كإدخال.

المَعلمات

الاسمالنوعالوصف
dataStringسلسلة الكائن الثنائي الكبير (blob) بافتراض أنّها UTF-8

تذكرة ذهاب وعودة

Blob: Blob الذي تم إنشاؤه حديثًا


newBlob(data, contentType)

إنشاء كائن Blob جديد من السلسلة ونوع المحتوى. تُستخدم الكائنات الثنائية الكبيرة في العديد من واجهات برمجة التطبيقات لبرمجة التطبيقات التي تستخدم البيانات الثنائية كإدخال.

المَعلمات

الاسمالنوعالوصف
dataStringسلسلة الكائن الثنائي الكبير (blob) بافتراض أنّها UTF-8
contentTypeStringنوع المحتوى كائن ثنائي كبير (blob) - يمكن أن يكون فارغًا

تذكرة ذهاب وعودة

Blob: Blob الذي تم إنشاؤه حديثًا


newBlob(data, contentType, name)

إنشاء كائن Blob جديد من سلسلة أو نوع محتوى أو اسم. يتم استخدام الكائنات الثنائية الكبيرة في العديد من واجهات برمجة التطبيقات لبرمجة التطبيقات التي تستخدم البيانات الثنائية كإدخال.

المَعلمات

الاسمالنوعالوصف
dataStringسلسلة الكائن الثنائي الكبير (blob) بافتراض أنّها UTF-8
contentTypeStringنوع المحتوى كائن ثنائي كبير (blob) - يمكن أن يكون فارغًا
nameStringاسم الكائن الثنائي الكبير (blob) - يمكن أن يكون فارغًا

تذكرة ذهاب وعودة

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

المَعلمات

الاسمالنوعالوصف
csvStringسلسلة تحتوي على بيانات فردية أو متعددة الأسطر بتنسيق قيم مفصولة بفواصل (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');

المَعلمات

الاسمالنوعالوصف
csvStringسلسلة تحتوي على بيانات فردية أو متعددة الأسطر بتنسيق قيم مفصولة بفواصل (CSV)
delimiterCharبين القيمتَين

تذكرة ذهاب وعودة

String[][]: مصفوفة ثنائية الأبعاد تحتوي على القيم في سلسلة CSV


parseDate(date, timeZone, format)

يحلّل تاريخ السلسلة المقدَّم وفقًا للمواصفات الموضّحة في فئة الإصدار العادي من Java 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);

المَعلمات

الاسمالنوعالوصف
dateStringقيمة سلسلة لتحليلها كتاريخ.
timeZoneStringالمنطقة الزمنية لنتائج البحث
formatStringتنسيق التاريخ حسب مواصفات SimpleDateFormat.

تذكرة ذهاب وعودة

Date - سلسلة الإدخال كتاريخ.


sleep(milliseconds)

مرات السكون لعدد محدد من المللي ثانية. يضع النص البرمجي فورًا في وضع السكون لعدد محدد من الملي ثانية. الحد الأقصى للقيمة المسموح بها هو 300,000 (أو 5 دقائق).

المَعلمات

الاسمالنوعالوصف
millisecondsIntegerعدد الملي ثانية التي سيتم ضبطها على وضع السكون.

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

المَعلمات

الاسمالنوعالوصف
blobBlobSourceBlob للبيانات المضغوطة.

تذكرة ذهاب وعودة

BlobBlob تمثّل البيانات غير المضغوطة.


unzip(blob)

تأخذ Blob رمزًا لملف ZIP ويعرض ملفاته المكوّنة.

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

المَعلمات

الاسمالنوعالوصف
blobBlobSourceكائن ملف ثنائي كبير.

تذكرة ذهاب وعودة

Blob[] — كائن ثنائي كبير[] يمثل كائنًا ثنائيًا كبيرًا، يحمل كل منها اسم المسار الكامل داخل ملف ZIP


zip(blobs)

إنشاء كائن Blob جديد يكون عبارة عن ملف ZIP يحتوي على بيانات من 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]);

المَعلمات

الاسمالنوعالوصف
blobsBlobSource[]مصفوفة من الكائنات الثنائية الكبيرة ليتم ضغطها

تذكرة ذهاب وعودة

Blob: كائن ثنائي كبير يحتوي على الإدخالات كأرشيف


zip(blobs, name)

إنشاء كائن Blob جديد يكون عبارة عن ملف ZIP يحتوي على بيانات من 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");

المَعلمات

الاسمالنوعالوصف
blobsBlobSource[]مصفوفة من الكائنات الثنائية الكبيرة ليتم ضغطها
nameStringاسم ملف ZIP الذي سيتم إنشاؤه

تذكرة ذهاب وعودة

Blob: كائن ثنائي كبير يحتوي على الإدخالات كأرشيف

الطرق التي تم إيقافها نهائيًا