تمت ترجمة هذه الصفحة بواسطة 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 Standard Edition `SimpleDateFormat`.
`sleep(milliseconds)`	`void`	يتوقف عن العمل لفترة زمنية محدّدة بالمللي ثانية.
`ungzip(blob)`	`Blob`	تُزيل ضغط عنصر `Blob` وتعرض `Blob` يحتوي على data غير المضغوطة.
`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 グループ"
const base64data = 'R29vZ2xlIOOCsOODq+ODvOODlw==';

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
const decoded = Utilities.base64Decode(base64data);
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

المعلَمات

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

الإرجاع

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

`base64Decode(encoded, charset)`

فك ترميز سلسلة مُشفّرة بترميز base-64 إلى صفيف وحدات بايت في مجموعة أحرف معيّنة

// This is the base64 encoded form of "Google グループ"
const base64data = 'R29vZ2xlIOOCsOODq+ODvOODlw==';

const decoded = Utilities.base64Decode(base64data, Utilities.Charset.UTF_8);

// This logs:
//     [71, 111, 111, 103, 108, 101, 32, -29, -126, -80,
//      -29, -125, -85, -29, -125, -68, -29, -125, -105]
Logger.log(decoded);

// If we want a String instead of a byte array:
// This logs the original "Google グループ"
Logger.log(Utilities.newBlob(decoded).getDataAsString());

المعلَمات

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

الإرجاع

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

`base64DecodeWebSafe(encoded)`

فك ترميز سلسلة مشفّرة بترميز base-64 متوافق مع الويب إلى صفيف بايت UTF-8

// This is the base64 web-safe encoded form of "Google グループ"
const base64data = 'R29vZ2xlIOOCsOODq-ODvOODlw==';

const 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 グループ"
const base64data = 'R29vZ2xlIOOCsOODq-ODvOODlw==';

const 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 هو ترميز شائع تستخدمه مجموعة متنوعة من الأدوات التي لا يمكنها قبول البيانات الثنائية. يتم استخدام قاعدة 64 بشكل شائع في بروتوكولات الإنترنت، مثل البريد الإلكتروني أو HTTP أو في مستندات XML.

// Instantiates a blob here for clarity
const blob = Utilities.newBlob('A string here');

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
const encoded = Utilities.base64Encode(blob.getBytes());
Logger.log(encoded);

المعلَمات

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

الإرجاع

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

`base64Encode(data)`

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

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

المعلَمات

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

الإرجاع

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

`base64Encode(data, charset)`

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

// "Google Groups" in Katakana (Japanese)
const input = 'Google グループ';

// Writes "R29vZ2xlIOOCsOODq+ODvOODlw==" to the log
const encoded = Utilities.base64Encode(input, Utilities.Charset.UTF_8);
Logger.log(encoded);

المعلَمات

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

الإرجاع

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

`base64EncodeWebSafe(data)`

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

// Instantiates a blob here for clarity
const blob = Utilities.newBlob('A string here');

// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log.
const encoded = Utilities.base64EncodeWebSafe(blob.getBytes());
Logger.log(encoded);

المعلَمات

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

الإرجاع

String: تمثيل البيانات المُرسَلة بترميز base-64 الآمن على الويب

`base64EncodeWebSafe(data)`

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

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

المعلَمات

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

الإرجاع

String: التمثيل المشفّر بترميز base-64 الآمن على الويب لسلسلة الإدخال

`base64EncodeWebSafe(data, charset)`

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

// "Google Groups" in Katakana (Japanese)
const input = 'Google グループ';

// Writes "R29vZ2xlIOOCsOODq-ODvOODlw==" to the log
const encoded = Utilities.base64EncodeWebSafe(input, Utilities.Charset.UTF_8);
Logger.log(encoded);

المعلَمات

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

الإرجاع

String: التمثيل المشفّر بترميز base-64 الآمن على الويب لسلسلة الإدخال باستخدام Charset المحدّد

`computeDigest(algorithm, value)`

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

const input = Utilities.base64Decode(
    'aW5wdXQgdG8gaGFzaA0K');  // == base64encode("input to hash")
const digest = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5, input);
Logger.log(digest);

المعلَمات

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

الإرجاع

‫Byte[]: بايت[] يمثّل خلاصة الإخراج

`computeDigest(algorithm, value)`

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

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

المعلَمات

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

الإرجاع

‫Byte[]: بايت[] يمثّل خلاصة الإخراج

`computeDigest(algorithm, value, charset)`

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

const 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.
const input = Utilities.base64Decode(
    'aW5wdXQgdG8gaGFzaA0K');                 // == base64encode("input to hash")
const key = Utilities.base64Decode('a2V5');  // == base64encode("key")
const 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.
const 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.
const 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.
const input = Utilities.base64Decode(
    'aW5wdXQgdG8gaGFzaA0K');                 // == base64encode("input to hash")
const key = Utilities.base64Decode('a2V5');  // == base64encode("key")
const 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.
const 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.
const 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.
const signature = Utilities.computeRsaSha1Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
Logger.log(signature);

المعلَمات

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

الإرجاع

‫Byte[]: بايت[] يمثّل توقيع الإخراج

`computeRsaSha1Signature(value, key, charset)`

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

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSha1Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
    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.
const signature = Utilities.computeRsaSha256Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
Logger.log(signature);

المعلَمات

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

الإرجاع

‫Byte[]: بايت[] يمثّل توقيع الإخراج

`computeRsaSha256Signature(value, key, charset)`

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

// This writes an array of bytes to the log.
const signature = Utilities.computeRsaSha256Signature(
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
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.
const signature = Utilities.computeRsaSignature(
    Utilities.RsaAlgorithm.RSA_SHA_256,
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
);
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.
const signature = Utilities.computeRsaSignature(
    Utilities.RsaAlgorithm.RSA_SHA_256,
    'this is my input',
    PropertiesService.getScriptProperties().getProperty('YOUR_PRIVATE_KEY'),
    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.
const 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.
const myDataObject = {
  tempId: Utilities.getUuid(),
};

الإرجاع

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

`gzip(blob)`

‫gzip- تُحسِّن بيانات Blob المقدَّمة وتُعيد عرضها في عنصر Blob جديد.

const textBlob = Utilities.newBlob(
    'Some text to compress using gzip compression',
);

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

المعلَمات

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

الإرجاع

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

`gzip(blob, name)`

‫gzip- تُحسِّن بيانات Blob المقدَّمة وتُعيد عرضها في عنصر Blob جديد. يسمح هذا الإصدار من الطريقة بتحديد اسم ملف.

const textBlob = Utilities.newBlob(
    'Some text to compress using gzip compression',
);

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

المعلَمات

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

الإرجاع

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

`newBlob(data)`

أنشئ عنصر Blob جديدًا من صفيف بايت. تُستخدَم ملفات البيانات غير القابلة للتغيير في العديد من واجهات برمجة التطبيقات في Apps Script التي تأخذ البيانات الثنائية كمدخلات.

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

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

المعلَمات

الاسم	النوع	الوصف
`data`	`Byte[]`	وحدات البايت الخاصة بالملفّ.

الإرجاع

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

`newBlob(data, contentType)`

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

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

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

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

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

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

المعلَمات

الاسم	النوع	الوصف
`data`	`Byte[]`	وحدات البايت الخاصة بالملفّ.
`contentType`	`String`	نوع محتوى العنصر المصغّر، ويمكن أن يكون `null`.

الإرجاع

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

`newBlob(data, contentType, name)`

أنشئ عنصر Blob جديدًا من صفيف بايت ونوع محتوى واسم. تُستخدَم ملفات البيانات غير القابلة للتعديل في العديد من واجهات برمجة تطبيقات Apps Script التي تتلقّى البيانات الثنائية كإدخال.

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

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

// Declares the name of the blob.
const name = 'Example blob';

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

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

// Logs the content type of the blob to the console.
console.log('Blob content type:', blob.getContentType());

// Logs the name of the blob to the console.
console.log('Blob name:', blob.getName());

المعلَمات

الاسم	النوع	الوصف
`data`	`Byte[]`	وحدات البايت الخاصة بالملفّ.
`contentType`	`String`	‫- نوع محتوى العنصر المصغّر: يمكن أن يكون `null`.
`name`	`String`	اسم العنصر المصغّر، ويمكن أن يكون `null`.

الإرجاع

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

`newBlob(data)`

أنشئ عنصر Blob جديدًا من سلسلة. تُستخدَم ملفات البيانات غير القابلة للتغيير في العديد من واجهات برمجة التطبيقات في Apps Script التي تأخذ البيانات الثنائية كمدخلات.

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

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

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

المعلَمات

الاسم	النوع	الوصف
`data`	`String`	سلسلة البيانات غير القابلة للتغيير، والتي يُفترض أن تكون بترميز UTF-8

الإرجاع

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

`newBlob(data, contentType)`

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

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

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

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

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

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

المعلَمات

الاسم	النوع	الوصف
`data`	`String`	سلسلة البيانات غير القابلة للتغيير، والتي يُفترض أن تكون بترميز UTF-8
`contentType`	`String`	نوع محتوى العنصر المصغّر، ويمكن أن يكون `null`.

الإرجاع

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

`newBlob(data, contentType, name)`

أنشئ عنصر Blob جديدًا من سلسلة ونوع محتوى واسم. تُستخدَم ملفات البيانات غير القابلة للتعديل في العديد من واجهات برمجة تطبيقات Apps Script التي تتلقّى البيانات الثنائية كإدخال.

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

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

// Declares the name of the blob.
const name = 'Example blob';

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

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

// Logs the content type of the blob to the console.
console.log('Blob content type:', blob.getContentType());

// Logs the name of the blob to the console.
console.log('Blob name:', blob.getName());

المعلَمات

الاسم	النوع	الوصف
`data`	`String`	سلسلة البيانات غير القابلة للتغيير، والتي يُفترض أن تكون بترميز UTF-8
`contentType`	`String`	نوع محتوى العنصر المصغّر، ويمكن أن يكون `null`.
`name`	`String`	اسم العنصر المصغّر، ويمكن أن يكون `null`.

الإرجاع

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

`parseCsv(csv)`

تعرِض هذه الدالة تمثيلاً لمصفوفة ثنائية الأبعاد على شكل جدول لسلسلة CSV.

// This creates a two-dimensional array of the format [[a, b, c], [d, e, f]]
const csvString = 'a,b,c\nd,e,f';
const 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]]
const csvString = 'a\tb\tc\nd\te\tf';
const data = Utilities.parseCsv(csvString, '\t');

المعلَمات

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

الإرجاع

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

`parseDate(date, timeZone, format)`

تُحلِّل تاريخ السلسلة المقدَّم وفقًا للمواصفات الموضّحة في فئة Java Standard Edition 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.
const 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)`

يتوقف عن العمل لفترة زمنية محدّدة بالمللي ثانية. يُوقِف هذا الخيار النص البرمجي على الفور لفترة محددة بالملي ثانية. الحد الأقصى المسموح به هو 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());

المعلَمات

الاسم	النوع	الوصف
`milliseconds`	`Integer`	عدد المللي ثانية التي يتم فيها إيقاف المعالجة.

`ungzip(blob)`

تُزيل ضغط عنصر Blob وتعرض Blob يحتوي على data غير المضغوطة.

const textBlob = Utilities.newBlob(
    'Some text to compress using gzip compression',
);

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

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

المعلَمات

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

الإرجاع

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

`unzip(blob)`

تأخذ هذه الدالة عنصر Blob يمثّل ملف zip وتُرجع الملفات المكوّنة له.

const googleFavIconUrl = 'https://www.google.com/favicon.ico';
const googleLogoUrl = 'https://www.google.com/images/srpr/logo3w.png';

// Fetch the Google favicon.ico file and get the Blob data
const faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
const logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and
// logoBlob
const zip = Utilities.zip([faviconBlob, logoBlob], 'google_images.zip');

// This now unzips the blobs
const files = Utilities.unzip(zip);

المعلَمات

الاسم	النوع	الوصف
`blob`	`BlobSource`	ملف zip

الإرجاع

Blob[]: عنصر Blob[] يمثّل عناصر Blob للمكوّنات، ويتم تسمية كلّ عنصر منها بالمسار الكامل داخل ملف zip.

`zip(blobs)`

لإنشاء عنصر Blob جديد وهو ملف zip يحتوي على البيانات من Blobs التي تم تمريرها.

const googleFavIconUrl = 'https://www.google.com/favicon.ico';
const googleLogoUrl = 'https://www.google.com/images/srpr/logo3w.png';

// Fetch the Google favicon.ico file and get the Blob data
const faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
const logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and
// logoBlob
const zip = Utilities.zip([faviconBlob, logoBlob]);

المعلَمات

الاسم	النوع	الوصف
`blobs`	`BlobSource[]`	صفيف من ملفات البيانات المجمّعة التي سيتم ضغطها

الإرجاع

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

`zip(blobs, name)`

لإنشاء عنصر Blob جديد وهو ملف zip يحتوي على البيانات من Blobs التي تم تمريرها. يسمح هذا الإصدار من الطريقة بتحديد اسم ملف.

const googleFavIconUrl = 'https://www.google.com/favicon.ico';
const googleLogoUrl = 'https://www.google.com/images/srpr/logo3w.png';

// Fetch the Google favicon.ico file and get the Blob data
const faviconBlob = UrlFetchApp.fetch(googleFavIconUrl).getBlob();
const logoBlob = UrlFetchApp.fetch(googleLogoUrl).getBlob();

// zip now references a blob containing an archive of both faviconBlob and
// logoBlob
const 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"}
const 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"}
const person = {
  name: 'John Smith',
  company: 'Virginia Company',
};
const json = Utilities.jsonStringify(person);
Logger.log(json);

المعلَمات

الاسم	النوع	الوصف
`obj`	`Object`	عنصر JavaScript المطلوب تسلسله إلى تنسيق JSON

الإرجاع

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