Class Utilities

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

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

أماكن إقامة

الموقعTypeالوصف
CharsetCharset
DigestAlgorithmDigestAlgorithm
MacAlgorithmMacAlgorithm
RsaAlgorithmRsaAlgorithm

الطُرق

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

الوثائق التفصيلية

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

المَعلمات

الاسمTypeالوصف
encodedStringمصفوفة من وحدات بايت البيانات المطلوب فك ترميزها.

استرجاع الكرة

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

المَعلمات

الاسمTypeالوصف
encodedStringسلسلة البيانات المطلوب فك ترميزها.
charsetCharsetCharset يحدّد مجموعة أحرف الإدخال.

استرجاع الكرة

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

المَعلمات

الاسمTypeالوصف
encodedStringمصفوفة من وحدات البايت للبيانات الآمنة على الويب المطلوب فك ترميزها.

استرجاع الكرة

Byte[] - البيانات الأولية التي يتم تمثيلها بوسيطة web-safe المشفرة كمصفوفة بايت.


base64DecodeWebSafe(encoded, charset)

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

المَعلمات

الاسمTypeالوصف
encodedStringسلسلة البيانات الآمنة على الويب المطلوب فك ترميزها.
charsetCharsetCharset يحدّد مجموعة أحرف الإدخال.

استرجاع الكرة

Byte[] - البيانات الأولية التي يتم تمثيلها بوسيطة web-safe المشفرة كمصفوفة بايت.


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

المَعلمات

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

استرجاع الكرة

String — تمثيل بترميز base-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);

المَعلمات

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

استرجاع الكرة

String - تمثيل بترميز base-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);

المَعلمات

الاسمTypeالوصف
dataStringسلسلة البيانات المطلوب ترميزها.
charsetCharsetCharset يحدّد مجموعة أحرف الإدخال.

استرجاع الكرة

String: تمثيل بترميز base-64 لسلسلة الإدخال مع القيمة Charset المحدّدة.


base64EncodeWebSafe(data)

تنشئ هذه الدالة سلسلة Base-64 مرمّزة آمنة على الويب من صفيف البايت المحدّد. يُعد Base 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);

المَعلمات

الاسمTypeالوصف
dataByte[]يشير ذلك المصطلح إلى مصفوفة من وحدات بايت البيانات المطلوب ترميزها.

استرجاع الكرة

String — التمثيل المرمّز الآمن على الويب لـ base-64 للبيانات التي تم تمريرها في البيانات.


base64EncodeWebSafe(data)

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

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

المَعلمات

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

استرجاع الكرة

String — التمثيل المشفّر base-64 لسلسلة الإدخال


base64EncodeWebSafe(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.base64EncodeWebSafe(input, Utilities.Charset.UTF_8);
Logger.log(encoded);

المَعلمات

الاسمTypeالوصف
dataStringسلسلة البيانات المطلوب ترميزها.
charsetCharsetCharset يحدّد مجموعة أحرف الإدخال.

استرجاع الكرة

String — التمثيل المشفّر base-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);

المَعلمات

الاسمTypeالوصف
algorithmDigestAlgorithmتمثّل هذه السمة DigestAlgorithm للاستخدام.
valueByte[]قيمة سلسلة إدخال لحساب ملخّص لها

استرجاع الكرة

Byte[] — وحدة بايت[] تمثِّل ملخّص المخرجات


computeDigest(algorithm, value)

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

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

المَعلمات

الاسمTypeالوصف
algorithmDigestAlgorithmتمثّل هذه السمة DigestAlgorithm للاستخدام.
valueStringقيمة سلسلة إدخال لحساب ملخّص لها

استرجاع الكرة

Byte[] — وحدة بايت[] تمثِّل ملخّص المخرجات


computeDigest(algorithm, value, charset)

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

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

المَعلمات

الاسمTypeالوصف
algorithmDigestAlgorithmتمثّل هذه السمة DigestAlgorithm للاستخدام.
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);

المَعلمات

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

المَعلمات

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

المَعلمات

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

المَعلمات

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

المَعلمات

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

المَعلمات

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

المَعلمات

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

المَعلمات

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

المَعلمات

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

المَعلمات

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

المَعلمات

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

المَعلمات

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

المَعلمات

الاسمTypeالوصف
dateDateتمثّل هذه السمة Date لتنسيقها كسلسلة.
timeZoneStringالمنطقة الزمنية للنتيجة للنتيجة
formatStringتنسيق حسب مواصفات SimpleDateFormat.

استرجاع الكرة

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


formatString(template, args)

تنفيذ تنسيق سلسلة يشبه sprintf باستخدام سلاسل تنسيق بنمط %'.

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

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

المَعلمات

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

المَعلمات

الاسمTypeالوصف
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");

المَعلمات

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

استرجاع الكرة

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


newBlob(data)

أنشئ كائن Blob جديد من صفيف بايت. تُستخدم وحدات تخزين البيانات الثنائية (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());

المَعلمات

الاسمTypeالوصف
dataByte[]وحدات البايت الخاصة بالكائن الثنائي الكبير.

استرجاع الكرة

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


newBlob(data, contentType)

أنشئ كائن Blob جديد من صفيف بايت ونوع المحتوى. تُستخدم وحدات تخزين البيانات الثنائية (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());

المَعلمات

الاسمTypeالوصف
dataByte[]وحدات البايت الخاصة بالكائن الثنائي الكبير.
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());

المَعلمات

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

استرجاع الكرة

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


newBlob(data)

أنشئ كائن Blob جديدًا من سلسلة. تُستخدم وحدات تخزين البيانات الثنائية (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());

المَعلمات

الاسمTypeالوصف
dataStringتمثّل هذه السمة سلسلة كائن blob، وهي تُفترَض بـ UTF-8.

استرجاع الكرة

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


newBlob(data, contentType)

أنشئ كائن Blob جديد من سلسلة ونوع محتوى. تُستخدم وحدات تخزين البيانات الثنائية (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());

المَعلمات

الاسمTypeالوصف
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());

المَعلمات

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

المَعلمات

الاسمTypeالوصف
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');

المَعلمات

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

استرجاع الكرة

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


parseDate(date, timeZone, format)

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

المَعلمات

الاسمTypeالوصف
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());

المَعلمات

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

المَعلمات

الاسمTypeالوصف
blobBlobSourceتمثّل هذه السمة Blob للبيانات المضغوطة.

استرجاع الكرة

Blob: مادة عرض Blob تمثّل البيانات غير المضغوطة.


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

المَعلمات

الاسمTypeالوصف
blobBlobSourceالملف المضغوط بتنسيق ZIP.

استرجاع الكرة

Blob[]: النقطة الثنائية الكبيرة[] التي تمثّل الكائنات الثنائية الكبيرة، وتسمى كل منها بالمسار الكامل داخل الرمز البريدي.


zip(blobs)

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

المَعلمات

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

استرجاع الكرة

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


zip(blobs, name)

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

المَعلمات

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

استرجاع الكرة

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

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