تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class Utilities

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

أماكن إقامة

الموقع	النوع	الوصف
`Charset`	`Charset`
`DigestAlgorithm`	`DigestAlgorithm`
`MacAlgorithm`	`MacAlgorithm`
`RsaAlgorithm`	`RsaAlgorithm`

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`base64Decode(encoded)`	`Byte[]`	فك ترميز سلسلة base-64 المرمّزة في مصفوفة UTF-8 بايت.
`base64Decode(encoded, charset)`	`Byte[]`	فك ترميز سلسلة base-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`	يحلّل تاريخ السلسلة المقدَّم وفقًا للمواصفات الموضحة في معيار 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 التي تم تمريرها.

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

الطريقة	نوع الإرجاع	وصف قصير
`jsonParse(jsonString)`	`Object`	عرض كائن مُطابِق لسلسلة JSON التي تم تمريرها.
`jsonStringify(obj)`	`String`	يمكنك عرض سلسلة JSON للعنصر الذي تم تمريره.

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

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

المعلمات

الاسم	النوع	الوصف
`encoded`	`String`	مصفوفة من وحدات بايت البيانات المطلوب فك ترميزها.

الإرجاع

Byte[] — البيانات الأولية التي تمثلها الوسيطة الأساسية 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());

المعلمات

الاسم	النوع	الوصف
`encoded`	`String`	سلسلة البيانات المطلوب فك ترميزها.
`charset`	`Charset`	عبارة عن `Charset` تحدد مجموعة أحرف الإدخال.

الإرجاع

Byte[] — البيانات الأولية التي تمثلها الوسيطة الأساسية 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());

المعلمات

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

الإرجاع

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

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

المعلمات

الاسم	النوع	الوصف
`encoded`	`String`	سلسلة البيانات الآمنة على الويب المطلوب فك ترميزها.
`charset`	`Charset`	عبارة عن `Charset` تحدد مجموعة أحرف الإدخال.

الإرجاع

Byte[] — البيانات الأولية التي تمثلها وسيطة مشفَّرة بترميز base-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);

المعلمات

الاسم	النوع	الوصف
`data`	`Byte[]`	بايت[] من البيانات المطلوب ترميزها.

الإرجاع

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

المعلمات

الاسم	النوع	الوصف
`data`	`String`	السلسلة المطلوب ترميزها.

الإرجاع

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

المعلمات

الاسم	النوع	الوصف
`data`	`String`	سلسلة البيانات المطلوب ترميزها.
`charset`	`Charset`	عبارة عن `Charset` تحدد مجموعة أحرف الإدخال.

الإرجاع

String — تمثيل base-64 المشفر لسلسلة الإدخال مع Charset المحدد.

`base64EncodeWebSafe(data)`

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

المعلمات

الاسم	النوع	الوصف
`data`	`Byte[]`	مصفوفة من وحدات بايت البيانات المطلوب ترميزها.

الإرجاع

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

`base64EncodeWebSafe(data)`

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

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

المعلمات

الاسم	النوع	الوصف
`data`	`String`	السلسلة المطلوب ترميزها.

الإرجاع

String — تمثيل بترميز base-64 آمن على الويب لسلسلة الإدخال.

`base64EncodeWebSafe(data, charset)`

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

المعلمات

الاسم	النوع	الوصف
`data`	`String`	سلسلة البيانات المطلوب ترميزها.
`charset`	`Charset`	عبارة عن `Charset` تحدد مجموعة أحرف الإدخال.

الإرجاع

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

المعلمات

الاسم	النوع	الوصف
`algorithm`	`DigestAlgorithm`	`DigestAlgorithm` للاستخدام.
`value`	`Byte[]`	قيمة سلسلة إدخال يتم احتسابها لحساب الملخص.

الإرجاع

Byte[] — بايت[] يمثّل ملخّص النتائج

`computeDigest(algorithm, value)`

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

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

المعلمات

الاسم	النوع	الوصف
`algorithm`	`DigestAlgorithm`	`DigestAlgorithm` للاستخدام.
`value`	`String`	قيمة سلسلة إدخال يتم احتسابها لحساب الملخص.

الإرجاع

Byte[] — بايت[] يمثّل ملخّص النتائج

`computeDigest(algorithm, value, charset)`

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

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

المعلمات

الاسم	النوع	الوصف
`algorithm`	`DigestAlgorithm`	`DigestAlgorithm` للاستخدام.
`value`	`String`	قيمة سلسلة إدخال يتم احتسابها لحساب الملخص.
`charset`	`Charset`	تمثّل هذه السمة `Charset` مجموعة رموز الإدخال.

الإرجاع

Byte[] — بايت[] يمثّل ملخّص النتائج

`computeHmacSha256Signature(value, key)`

توقيع القيمة المقدمة باستخدام HMAC-SHA256 باستخدام المفتاح المحدد.

// This writes an array of bytes to the log.
var input = Utilities.base64Decode("aW5wdXQgdG8gaGFzaA0K") // == base64encode("input to hash")
var key = Utilities.base64Decode("a2V5"); // == base64encode("key")
var signature = Utilities.computeHmacSha256Signature(input, key);
Logger.log(signature);

المعلمات

الاسم	النوع	الوصف
`value`	`Byte[]`	القيمة المدخلة لإنشاء تجزئة لها.
`key`	`Byte[]`	مفتاح يتم استخدامه لإنشاء التجزئة باستخدامه.

الإرجاع

Byte[] - بايت[] يمثّل توقيع المخرجات.

`computeHmacSha256Signature(value, key)`

توقيع القيمة المقدمة باستخدام HMAC-SHA256 باستخدام المفتاح المحدد.

// This writes an array of bytes to the log.
var signature = Utilities.computeHmacSha256Signature("this is my input",
                                                      "my key - use a stronger one");
Logger.log(signature);

المعلمات

الاسم	النوع	الوصف
`value`	`String`	القيمة المدخلة لإنشاء تجزئة لها.
`key`	`String`	مفتاح يتم استخدامه لإنشاء التجزئة باستخدامه.

الإرجاع

Byte[] - بايت[] يمثّل توقيع المخرجات.

`computeHmacSha256Signature(value, key, charset)`

تضع علامة على القيمة المقدمة باستخدام HMAC-SHA256 مع المفتاح ومجموعة الأحرف المحددة.

// This writes an array of bytes to the log.
var signature = Utilities.computeHmacSha256Signature("this is my input",
                                                     "my key - use a stronger one",
                                                     Utilities.Charset.US_ASCII);
Logger.log(signature);

المعلمات

الاسم	النوع	الوصف
`value`	`String`	القيمة المدخلة لإنشاء تجزئة لها.
`key`	`String`	مفتاح يتم استخدامه لإنشاء التجزئة باستخدامه.
`charset`	`Charset`	تمثّل هذه السمة `Charset` مجموعة رموز الإدخال.

الإرجاع

Byte[] — بايت[] يمثّل توقيع المخرجات.

`computeHmacSignature(algorithm, value, key)`

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

// This writes an array of bytes to the log.
var input = Utilities.base64Decode("aW5wdXQgdG8gaGFzaA0K") // == base64encode("input to hash")
var key = Utilities.base64Decode("a2V5"); // == base64encode("key")
var signature = Utilities.computeHmacSignature(Utilities.MacAlgorithm.HMAC_MD5, input, key);
Logger.log(signature);

المعلمات

الاسم	النوع	الوصف
`algorithm`	`MacAlgorithm`	خوارزمية `MacAlgorithm` التي يتم استخدامها لتجزئة قيمة الإدخال.
`value`	`Byte[]`	القيمة المدخلة لإنشاء تجزئة لها.
`key`	`Byte[]`	مفتاح يتم استخدامه لإنشاء التجزئة باستخدامه.

الإرجاع

Byte[] — بايت[] يمثّل توقيع المخرجات.

`computeHmacSignature(algorithm, value, key)`

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

// This writes an array of bytes to the log.
var signature = Utilities.computeHmacSignature(Utilities.MacAlgorithm.HMAC_MD5,
                                               "input to hash",
                                               "key");
Logger.log(signature);

المعلمات

الاسم	النوع	الوصف
`algorithm`	`MacAlgorithm`	خوارزمية `MacAlgorithm` التي يتم استخدامها لتجزئة قيمة الإدخال.
`value`	`String`	القيمة المدخلة لإنشاء تجزئة لها.
`key`	`String`	مفتاح يتم استخدامه لإنشاء التجزئة باستخدامه.

الإرجاع

Byte[] — بايت[] يمثّل توقيع المخرجات.

`computeHmacSignature(algorithm, value, key, charset)`

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

// This writes an array of bytes to the log.
var signature = Utilities.computeHmacSignature(Utilities.MacAlgorithm.HMAC_MD5,
                                               "input to hash",
                                               "key",
                                               Utilities.Charset.US_ASCII);
Logger.log(signature);

المعلمات

الاسم	النوع	الوصف
`algorithm`	`MacAlgorithm`	خوارزمية `MacAlgorithm` التي يتم استخدامها لتجزئة قيمة الإدخال.
`value`	`String`	القيمة المدخلة لإنشاء تجزئة لها.
`key`	`String`	مفتاح يتم استخدامه لإنشاء التجزئة باستخدامه.
`charset`	`Charset`	تمثّل هذه السمة `Charset` مجموعة رموز الإدخال.

الإرجاع

Byte[] — بايت[] يمثّل توقيع المخرجات.

`computeRsaSha1Signature(value, key)`

توقيع القيمة المقدمة باستخدام RSA-SHA1 بالمفتاح المحدد.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha1Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

المعلمات

الاسم	النوع	الوصف
`value`	`String`	القيمة المدخلة لإنشاء تجزئة لها.
`key`	`String`	مفتاح بتنسيق PEM لاستخدامه في إنشاء التوقيع

الإرجاع

Byte[] — بايت[] يمثّل توقيع المخرجات.

`computeRsaSha1Signature(value, key, charset)`

تضع توقيعًا على القيمة المقدمة باستخدام RSA-SHA1 مع المفتاح ومجموعة الأحرف المحددة.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha1Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n"
    Utilities.Charset.US_ASCII);
Logger.log(signature);

المعلمات

الاسم	النوع	الوصف
`value`	`String`	القيمة المدخلة لإنشاء تجزئة لها.
`key`	`String`	مفتاح بتنسيق PEM لاستخدامه في إنشاء التوقيع
`charset`	`Charset`	تمثّل هذه السمة `Charset` مجموعة رموز الإدخال.

الإرجاع

Byte[] — بايت[] يمثّل توقيع المخرجات.

`computeRsaSha256Signature(value, key)`

تضع توقيعًا على القيمة المقدمة باستخدام RSA-SHA256 بالمفتاح المحدد.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha256Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

المعلمات

الاسم	النوع	الوصف
`value`	`String`	القيمة المدخلة لإنشاء تجزئة لها.
`key`	`String`	مفتاح بتنسيق PEM لاستخدامه في إنشاء التوقيع

الإرجاع

Byte[] — بايت[] يمثّل توقيع المخرجات.

`computeRsaSha256Signature(value, key, charset)`

تضع توقيعًا على القيمة المقدمة باستخدام RSA-SHA256 بالمفتاح المحدد.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSha256Signature("this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

المعلمات

الاسم	النوع	الوصف
`value`	`String`	القيمة المدخلة لإنشاء تجزئة لها.
`key`	`String`	مفتاح بتنسيق PEM لاستخدامه في إنشاء التوقيع
`charset`	`Charset`	تمثّل هذه السمة `Charset` مجموعة رموز الإدخال.

الإرجاع

Byte[] — بايت[] يمثّل توقيع المخرجات.

`computeRsaSignature(algorithm, value, key)`

توقيع القيمة المقدمة باستخدام خوارزمية RSA المحددة بالمفتاح المحدد.

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSignature(Utilities.RsaAlgorithm.RSA_SHA_256,
    "this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n");
Logger.log(signature);

المعلمات

الاسم	النوع	الوصف
`algorithm`	`RsaAlgorithm`	خوارزمية `RsaAlgorithm` التي يتم استخدامها لتجزئة قيمة الإدخال.
`value`	`String`	القيمة المدخلة لإنشاء تجزئة لها.
`key`	`String`	مفتاح بتنسيق PEM لاستخدامه في إنشاء التوقيع

الإرجاع

Byte[] — بايت[] يمثّل توقيع المخرجات.

`computeRsaSignature(algorithm, value, key, charset)`

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

// This writes an array of bytes to the log.
var signature = Utilities.computeRsaSignature(Utilities.RsaAlgorithm.RSA_SHA_256,
    "this is my input",
    "-----BEGIN PRIVATE KEY-----\nprivatekeyhere\n-----END PRIVATE KEY-----\n",
    Utilities.Charset.US_ASCII);
Logger.log(signature);

المعلمات

الاسم	النوع	الوصف
`algorithm`	`RsaAlgorithm`	خوارزمية `RsaAlgorithm` التي يتم استخدامها لتجزئة قيمة الإدخال.
`value`	`String`	القيمة المدخلة لإنشاء تجزئة لها.
`key`	`String`	مفتاح بتنسيق PEM لاستخدامه في إنشاء التوقيع
`charset`	`Charset`	تمثّل هذه السمة `Charset` مجموعة رموز الإدخال.

الإرجاع

Byte[] — بايت[] يمثّل توقيع المخرجات.

`formatDate(date, timeZone, format)`

يتم تنسيق التاريخ وفقًا للمواصفات الموضحة في فئة Java SE SimpleDateFormat. من فضلك انتقل إلى المواصفات على http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html

// This formats the date as Greenwich Mean Time in the format
// year-month-dateThour-minute-second.
var formattedDate = Utilities.formatDate(new Date(), "GMT", "yyyy-MM-dd'T'HH:mm:ss'Z'");
Logger.log(formattedDate);

المعلمات

الاسم	النوع	الوصف
`date`	`Date`	هو `Date` للتنسيق كسلسلة.
`timeZone`	`String`	المنطقة الزمنية للناتج.
`format`	`String`	تمثّل هذه السمة تنسيقًا وفقًا لمواصفات `SimpleDateFormat`.

الإرجاع

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

`formatString(template, args)`

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

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

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

المعلمات

الاسم	النوع	الوصف
`template`	`String`	سلسلة التنسيق التي تتحكم في ما يتم عرضه.
`args`	`Object...`	الكائنات المطلوب استخدامها لملء '%' والعناصر النائبة في القالب.

الإرجاع

String — السلسلة المنسَّقة.

`getUuid()`

احصل على معرّف فريد عالمي (UUID) كسلسلة (يعادل استخدام الطريقة java.util.UUID.randomUUID()). ولا يمكن ضمان أن يكون هذا المعرّف فريدًا عبر في جميع الأوقات والمساحات. لذلك، لا تستخدِمه في الحالات التي يكون فيها التفرُّد المضمون مطلوبًا.

//This assigns a UUID as a temporary ID for a data object you are creating in your script.
var myDataObject = {
   tempId: Utilities.getUuid();
};

الإرجاع

String — تمثيل سلسلة للمعرّف الفريد العالمي (UUID).

`gzip(blob)`

يضغط gzip بيانات Blob المقدّمة ويعرضها في كائن Blob جديد.

var textBlob = Utilities.newBlob("Some text to compress using gzip compression");

// Create the compressed blob.
var gzipBlob = Utilities.gzip(textBlob);

المعلمات

الاسم	النوع	الوصف
`blob`	`BlobSource`	عنصر `Blob` المطلوب ضغطه باستخدام `gzip`.

الإرجاع

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

`gzip(blob, name)`

يضغط gzip بيانات Blob المقدّمة ويعرضها في كائن Blob جديد. يتيح هذا الإصدار من الطريقة تحديد اسم ملف.

var textBlob = Utilities.newBlob("Some text to compress using gzip compression");

// Create the compressed blob.
var gzipBlob = Utilities.gzip(textBlob, "text.gz");

المعلمات

الاسم	النوع	الوصف
`blob`	`BlobSource`	عنصر `Blob` المطلوب ضغطه باستخدام `gzip`.
`name`	`String`	اسم الملف الذي سيتم إنشاؤه من قِبل "`gzip`"

الإرجاع

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

`newBlob(data)`

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

// Creates a blob object from a byte array.
const data = [71, 79, 79, 71, 76, 69];
const blob = Utilities.newBlob(data);

// Logs the blob data as a string to the console.
console.log(blob.getDataAsString());

المعلمات

الاسم	النوع	الوصف
`data`	`Byte[]`	وحدات البايت الخاصة بالكائن الثنائي الكبير (blob).

الإرجاع

Blob — الكائن الثنائي الجديد (Blob) الذي تم إنشاؤه حديثًا

`newBlob(data, contentType)`

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

// Declares a byte array.
const data = [71, 79, 79, 71, 76, 69];

// Declares the content type of the blob.
const contentType = 'application/json';

// Creates a blob object from the byte array and content type.
const blob = Utilities.newBlob(data, contentType);

// Logs the blob data as a string to the console.
console.log(blob.getDataAsString());

// Logs the content type of the blob to the console.
console.log(blob.getContentType());

المعلمات

الاسم	النوع	الوصف
`data`	`Byte[]`	وحدات البايت الخاصة بالكائن الثنائي الكبير (blob).
`contentType`	`String`	نوع محتوى الكائن الثنائي الكبير (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());

المعلمات

الاسم	النوع	الوصف
`data`	`Byte[]`	وحدات البايت الخاصة بالكائن الثنائي الكبير (blob).
`contentType`	`String`	- نوع محتوى الكائن الثنائي الكبير - يمكن أن يكون `null`.
`name`	`String`	اسم الكائن الثنائي الكبير - يمكن أن يكون `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());

المعلمات

الاسم	النوع	الوصف
`data`	`String`	سلسلة الكائن الثنائي الكبير (blob) التي تفترض UTF-8.

الإرجاع

Blob — الكائن الثنائي الجديد (Blob) الذي تم إنشاؤه حديثًا

`newBlob(data, contentType)`

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

// Declares a string for the blob.
const data = 'GOOGLE';

// Declares the content type of blob.
const contentType = 'application/json';

// Creates a blob object from the string and content type.
const blob = Utilities.newBlob(data, contentType);

// Logs the blob data in byte array to the console.
console.log('Blob data:', blob.getBytes());

// Logs the content type of the blob to the console.
console.log(blob.getContentType());

المعلمات

الاسم	النوع	الوصف
`data`	`String`	سلسلة الكائن الثنائي الكبير (blob) التي تفترض UTF-8.
`contentType`	`String`	نوع محتوى الكائن الثنائي الكبير (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());

المعلمات

الاسم	النوع	الوصف
`data`	`String`	سلسلة الكائن الثنائي الكبير (blob) التي تفترض UTF-8.
`contentType`	`String`	نوع محتوى الكائن الثنائي الكبير (blob) - يمكن أن يكون `null`.
`name`	`String`	اسم الكائن الثنائي الكبير - يمكن أن يكون `null`.

الإرجاع

Blob — الكائن الثنائي الجديد (Blob) الذي تم إنشاؤه حديثًا

`parseCsv(csv)`

لعرض تمثيل صفيف ثنائي الأبعاد جدولي لسلسلة CSV.

// This creates a two-dimensional array of the format [[a, b, c], [d, e, f]]
var csvString = "a,b,c\nd,e,f";
var data = Utilities.parseCsv(csvString);

المعلمات

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

الإرجاع

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

`parseCsv(csv, delimiter)`

لعرض تمثيل صفيف ثنائي الأبعاد جدولي لسلسلة CSV باستخدام محدِّد مخصّص.

// This creates a two-dimensional array of the format [[a, b, c], [d, e, f]]
var csvString = "a\tb\tc\nd\te\tf";
var data = Utilities.parseCsv(csvString, '\t');

المعلمات

الاسم	النوع	الوصف
`csv`	`String`	سلسلة تحتوي على بيانات فردية أو متعددة الأسطر بقيمة مفصولة بفواصل (CSV) .
`delimiter`	`Char`	بين القيم.

الإرجاع

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

`parseDate(date, timeZone, format)`

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

المعلمات

الاسم	النوع	الوصف
`date`	`String`	قيمة سلسلة يلزم تحليلها كتاريخ.
`timeZone`	`String`	المنطقة الزمنية للناتج.
`format`	`String`	تمثّل هذه السمة تنسيق التاريخ وفقًا لمواصفات `SimpleDateFormat`.

الإرجاع

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

`sleep(milliseconds)`

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

// Creates a blob object from a string.
const data = 'GOOGLE';
const blob = Utilities.newBlob(data);

// Puts the script to sleep for 10,000 milliseconds (10 seconds).
Utilities.sleep(10000);

// Logs the blob data in byte array to the console.
console.log(blob.getBytes());

المعلمات

الاسم	النوع	الوصف
`milliseconds`	`Integer`	عدد المللي ثانية المتبقية في وضع السكون.

`ungzip(blob)`

يتم فك ضغط عنصر Blob وعرض عنصر Blob يحتوي على العنصر غير المضغوط. البيانات.

var textBlob = Utilities.newBlob("Some text to compress using gzip compression");

// Create the compressed blob.
var gzipBlob = Utilities.gzip(textBlob, "text.gz");

// Uncompress the data.
var uncompressedBlob = Utilities.ungzip(gzipBlob);

المعلمات

الاسم	النوع	الوصف
`blob`	`BlobSource`	تمثّل هذه السمة `Blob` من البيانات المضغوطة.

الإرجاع

Blob — عبارة عن Blob تمثِّل البيانات التي تم فك ضغطها.

`unzip(blob)`

يتم أخذ كائن Blob لتمثيل ملف 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);

المعلمات

الاسم	النوع	الوصف
`blob`	`BlobSource`	الكائن الثنائي الكبير (blob) في ملف ZIP.

الإرجاع

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

المعلمات

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

الإرجاع

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

المعلمات

الاسم	النوع	الوصف
`blobs`	`BlobSource[]`	مصفوفة من الملفات الثنائية الكبيرة للضغط عليها.
`name`	`String`	اسم ملف ZIP المراد إنشاؤه.

الإرجاع

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

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

`jsonParse(jsonString)`

تمّت إزالة هذا العمود. اعتبارًا من تشرين الثاني (نوفمبر) 2013، حلَّ محلّه JSON.parse()

عرض كائن مُطابِق لسلسلة JSON التي تم تمريرها.

// Returns the object { name: "John Smith", company: "Virginia Company"}
var obj = Utilities.jsonParse('{"name":"John Smith","company":"Virginia Company"}');

المعلمات

الاسم	النوع	الوصف
`jsonString`	`String`	تمثيل سلسلة لكائن JavaScript المطلوب إلغاء تسلسله.

الإرجاع

Object — تمثيل كائن JavaScript للإدخال.

`jsonStringify(obj)`

تمّت إزالة هذا العمود. اعتبارًا من تشرين الثاني (نوفمبر) 2013، حلَّ محلّه JSON.stringify()

يمكنك عرض سلسلة JSON للعنصر الذي تم تمريره.

// Logs: {"name":"John Smith","company":"Virginia Company"}
var person = { name: "John Smith", company: "Virginia Company" };
var json = Utilities.jsonStringify(person);
Logger.log(json);

المعلمات

الاسم	النوع	الوصف
`obj`	`Object`	تنفيذ كائن JavaScript بشكل تسلسلي إلى JSON

الإرجاع

String: كائن JavaScript تسلسلي بتنسيق JSON