Class Utilities

برامج الخدمات

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

أماكن إقامة

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

الطُرق

الطريقةنوع الإرجاعوصف قصير
base64Decode(encoded)Byte[]يفك تشفير سلسلة بترميز Base-64 في مصفوفة UTF-8 بايت.
base64Decode(encoded, charset)Byte[]يفك تشفير سلسلة بترميز Base-64 في مصفوفة بايت في مجموعة أحرف معيّنة.
base64DecodeWebSafe(encoded)Byte[]يفك تشفير سلسلة مشفّرة محمية بموجب معيار 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تنشئ سلسلة أساسية مُشفّرة بالترميز 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يتم تنسيق التاريخ وفقًا للمواصفات الموضّحة في فئة JSE 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)

يفك تشفير سلسلة مشفّرة محمية بموجب معيار 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 مرمّزة من مصفوفة "بايت". القاعدة 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);

المعلّمات

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

رحلة العودة

String — تمثيل مقترَح أساسي بقيمة 64 حرفًا للبيانات التي تم تمريرها.


base64Encode(data)

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

تنشئ سلسلة أساسية مُشفّرة بالترميز 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.base64EncodeWebSafe(blob.getBytes());
Logger.log(encoded);

المعلّمات

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

رحلة العودة

String: تمثيل مُشفَّر آمن للاستخدام على الويب لمدة 64 عامًا للبيانات التي تم تمريرها في البيانات.


base64EncodeWebSafe(data)

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

المعلّمات

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

المعلّمات

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

المعلّمات

الاسمالنوعالوصف
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 لاستخدامه في إنشاء التوقيع.
charsetCharsetتمثّل هذه السمة 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);

المعلّمات

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

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

المعلّمات

الاسمالنوعالوصف
dateDateتمثّل هذه السمة Date بتنسيق كسلسلة.
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: تمثيل سلسلة المعرّف الفريد العالمي


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 جديدًا من مصفوفة بايت. يتم استخدام البيانات الثنائية في العديد من واجهات برمجة تطبيقات "برمجة التطبيقات" التي تستخدم البيانات الثنائية كإدخال.

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

المعلّمات

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

رحلة العودة

Blob: Blob الذي تم إنشاؤه مؤخرًا


newBlob(data, contentType)

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

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

المعلّمات

الاسمالنوعالوصف
dataByte[]وحدات البايت بالنسبة إلى الكائن الثنائي الكبير (blob)
contentTypeStringيمكن أن يكون نوع المحتوى الكائن الثنائي الكبير (blob) null.

رحلة العودة

Blob: Blob الذي تم إنشاؤه مؤخرًا


newBlob(data, contentType, name)

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

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

المعلّمات

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

رحلة العودة

Blob: Blob الذي تم إنشاؤه مؤخرًا


newBlob(data)

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

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

المعلّمات

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

رحلة العودة

Blob: Blob الذي تم إنشاؤه مؤخرًا


newBlob(data, contentType)

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

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

المعلّمات

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

رحلة العودة

Blob: Blob الذي تم إنشاؤه مؤخرًا


newBlob(data, contentType, name)

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

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

المعلّمات

الاسمالنوعالوصف
dataStringسلسلة الكائن الثنائي الكبير (blob) التي يُفترض أنّها UTF-8.
contentTypeStringيمكن أن يكون نوع المحتوى الكائن الثنائي الكبير (blob) null.
nameStringيمكن أن يكون اسم الكائن الثنائي الكبير (blob) 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);

المعلّمات

الاسمالنوعالوصف
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. لمزيد من المعلومات، يمكنك الاطّلاع على فئة SimpleDateFormat في Java.

// 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 دقائق).

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

المعلّمات

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

رحلة العودة

Blob[] — فقاعة مربّعة[] تمثّل الكائنات الثنائية الكبيرة (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: كائن جديد يحتوي على الإدخالات كأرشيف

طرق متوقّفة نهائيًا