توفّر هذه الخدمة أدوات لترميز أو فك ترميز التنسيق وتنسيق التاريخ ومعالجة JSON وغير ذلك من المهام المتنوعة.
أماكن إقامة
الخاصية | Type | الوصف |
---|---|---|
Charset | Charset | |
DigestAlgorithm | DigestAlgorithm | |
MacAlgorithm | MacAlgorithm | |
RsaAlgorithm | RsaAlgorithm |
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
base64Decode(encoded) | Byte[] | يفك تشفير سلسلة بترميز Base-64 في مصفوفة UTF-8 بايت. |
base64Decode(encoded, charset) | Byte[] | يفك تشفير سلسلة بترميز Base-64 في مصفوفة بايت في مجموعة أحرف معيّنة. |
base64DecodeWebSafe(encoded) | Byte[] | يفك تشفير سلسلة مشفّرة محمية بموجب معيار 64 للويب، في مصفوفة UTF-8 بايت |
base64DecodeWebSafe(encoded, charset) | Byte[] | يفك تشفير سلسلة مشفّرة محمية بموجب معيار 64 للويب، في مصفوفة بايت بمجموعة رموز معيّنة. |
base64Encode(data) | String | تنشئ سلسلة Base-64 مرمّزة من مصفوفة "بايت". |
base64Encode(data) | String | تنشئ سلسلة مشفّرة Base-64 من السلسلة المحددة. |
base64Encode(data, charset) | String | تنشئ سلسلة Base-64 مرمّزة من السلسلة المحدّدة في مجموعة أحرف محدّدة. |
base64EncodeWebSafe(data) | String | تنشئ سلسلة أساسية مُشفّرة بالترميز 64 للويب، وتكون صفيفًا من مصفوفة "بايت". |
base64EncodeWebSafe(data) | String | تنشئ سلسلة أساسية مُشفّرة بالتوافق مع الويب 64 من السلسلة المحدّدة. |
base64EncodeWebSafe(data, charset) | String | تنشئ سلسلة أساسية مُشفّرة بالترميز 64 للويب، من السلسلة المحددة في مجموعة أحرف معيّنة. |
computeDigest(algorithm, value) | Byte[] | احسب ملخصًا باستخدام الخوارزمية المحدّدة للقيمة Byte[] المحدّدة. |
computeDigest(algorithm, value) | Byte[] | احسب ملخصًا باستخدام الخوارزمية المحدّدة للقيمة String المحدّدة. |
computeDigest(algorithm, value, charset) | Byte[] | احتسِب ملخصًا باستخدام خوارزمية محددة على القيمة String المحدّدة مع
مجموعة الأحرف المحدّدة. |
computeHmacSha256Signature(value, key) | Byte[] | وقِّع القيمة المقدَّمة باستخدام HMAC-SHA256 باستخدام المفتاح المتوفّر. |
computeHmacSha256Signature(value, key) | Byte[] | وقِّع القيمة المقدَّمة باستخدام HMAC-SHA256 باستخدام المفتاح المتوفّر. |
computeHmacSha256Signature(value, key, charset) | Byte[] | وقِّع القيمة المقدَّمة باستخدام HMAC-SHA256 مع ضبط المفتاح ومجموعة الأحرف المحدَّدَين. |
computeHmacSignature(algorithm, value, key) | Byte[] | احتسِب رمز مصادقة الرسائل باستخدام الخوارزمية المحدَّدة على المفتاح والقيمة المحدَّدَين. |
computeHmacSignature(algorithm, value, key) | Byte[] | احتسِب رمز مصادقة الرسائل باستخدام الخوارزمية المحدَّدة على المفتاح والقيمة المحدَّدَين. |
computeHmacSignature(algorithm, value, key, charset) | Byte[] | احتسِب رمز مصادقة الرسائل باستخدام الخوارزمية المحدَّدة على المفتاح والقيمة المحدَّدَين. |
computeRsaSha1Signature(value, key) | Byte[] | تتيح هذه السياسة توقيع القيمة المقدَّمة باستخدام RSA-SHA1 باستخدام المفتاح المحدّد. |
computeRsaSha1Signature(value, key, charset) | Byte[] | توجِّه القيمة المُقدَّمة باستخدام RSA-SHA1 باستخدام المفتاح ومجموعة الأحرف المعيَّنَين. |
computeRsaSha256Signature(value, key) | Byte[] | وقِّع القيمة المقدَّمة باستخدام RSA-SHA256 باستخدام المفتاح المحدَّد. |
computeRsaSha256Signature(value, key, charset) | Byte[] | وقِّع القيمة المقدَّمة باستخدام RSA-SHA256 باستخدام المفتاح المحدَّد. |
computeRsaSignature(algorithm, value, key) | Byte[] | تتيح هذه السياسة توقيع القيمة المقدَّمة باستخدام خوارزمية RSA المحدّدة باستخدام المفتاح المعني. |
computeRsaSignature(algorithm, value, key, charset) | Byte[] | توقيع القيمة المقدَّمة باستخدام خوارزمية RSA المحدَّدة باستخدام مفتاح ومجموعة أحرف |
formatDate(date, timeZone, format) | String | يتم تنسيق التاريخ وفقًا للمواصفات الموضّحة في فئة JSE SE SimpleDateFormat |
formatString(template, args) | String | تؤدي هذه السياسة إلى تنسيق سلاسل البيانات التي تشبه sprintf باستخدام سلاسل التنسيق '%'. |
getUuid() | String | يمكنك الحصول على معرّف فريد عالمي (UUID) كسلسلة (ما يعادل استخدام طريقة java.util.UUID.randomUUID() ). |
gzip(blob) | Blob | يضغط gzip بيانات Blob المقدَّمة ويعرضها في عنصر Blob جديد. |
gzip(blob, name) | Blob | يضغط gzip بيانات Blob المقدَّمة ويعرضها في عنصر Blob جديد. |
newBlob(data) | Blob | أنشِئ كائن Blob جديدًا من مصفوفة بايت. |
newBlob(data, contentType) | Blob | أنشِئ كائن Blob جديدًا من مصفوفة "بايت" ونوع محتوى. |
newBlob(data, contentType, name) | Blob | إنشاء كائن Blob جديد من مصفوفة بايت أو نوع محتوى أو اسم |
newBlob(data) | Blob | إنشاء كائن Blob جديد من سلسلة |
newBlob(data, contentType) | Blob | إنشاء كائن Blob جديد من سلسلة ونوع محتوى |
newBlob(data, contentType, name) | Blob | إنشاء كائن Blob جديد من سلسلة ونوع محتوى واسم. |
parseCsv(csv) | String[][] | تعرض تمثيلاً مصفوفةً ثنائي الأبعاد جدوليًا لسلسلة CSV. |
parseCsv(csv, delimiter) | String[][] | لعرض تمثيل مصفوفة ثنائية الأبعاد لسلسلة CSV باستخدام محدِّد مخصص. |
parseDate(date, timeZone, format) | Date | يحلل تاريخ السلسلة المقدَّم وفقًا للمواصفات الموضّحة في فئة الإصدار العادي من Java SimpleDateFormat . |
sleep(milliseconds) | void | بيانات السكون لعدد محدد من الملي ثانية |
ungzip(blob) | Blob | يتم فك ضغط عنصر Blob وعرض Blob يحتوي على البيانات غير المضغوطة. |
unzip(blob) | Blob[] | يحصل على Blob الذي يمثل ملف zip ويعرض ملفات المكونات. |
zip(blobs) | Blob | يتم إنشاء عنصر Blob جديد هو ملف ZIP يحتوي على البيانات من Blobs التي تم تمريرها. |
zip(blobs, name) | Blob | يتم إنشاء عنصر Blob جديد هو ملف ZIP يحتوي على البيانات من Blobs التي تم تمريرها. |
المستندات التفصيلية
base64Decode(encoded)
يفك تشفير سلسلة بترميز Base-64 في مصفوفة UTF-8 بايت.
// This is the base64 encoded form of "Google グループ" var base64data = "R29vZ2xlIOOCsOODq+ODvOODlw=="; // This logs: // [71, 111, 111, 103, 108, 101, 32, -29, -126, -80, // -29, -125, -85, -29, -125, -68, -29, -125, -105] var decoded = Utilities.base64Decode(base64data); Logger.log(decoded); // If we want a String instead of a byte array: // This logs the original "Google グループ" Logger.log(Utilities.newBlob(decoded).getDataAsString());
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
encoded | String | مصفوفة من وحدات البايت للبيانات التي يجب فك ترميزها. |
رحلة العودة
Byte[]
: البيانات الأولية التي تمثلها وسيطة Base-64 المشفرة كمصفوفة بايت.
base64Decode(encoded, charset)
يفك تشفير سلسلة بترميز Base-64 في مصفوفة بايت في مجموعة أحرف معيّنة.
// This is the base64 encoded form of "Google グループ" var base64data = "R29vZ2xlIOOCsOODq+ODvOODlw=="; var decoded = Utilities.base64Decode(base64data, Utilities.Charset.UTF_8); // This logs: // [71, 111, 111, 103, 108, 101, 32, -29, -126, -80, // -29, -125, -85, -29, -125, -68, -29, -125, -105] Logger.log(decoded); // If we want a String instead of a byte array: // This logs the original "Google グループ" Logger.log(Utilities.newBlob(decoded).getDataAsString());
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
encoded | String | سلسلة البيانات المطلوب فك ترميزها |
charset | Charset | تمثّل هذه السمة Charset مجموعة من أحرف الإدخال. |
رحلة العودة
Byte[]
: البيانات الأولية التي تمثلها وسيطة Base-64 المشفرة كمصفوفة بايت.
base64DecodeWebSafe(encoded)
يفك تشفير سلسلة مشفّرة محمية بموجب معيار 64 للويب، في مصفوفة UTF-8 بايت
// This is the base64 web-safe encoded form of "Google グループ" var base64data = "R29vZ2xlIOOCsOODq-ODvOODlw=="; var decoded = Utilities.base64DecodeWebSafe(base64data); // This logs: // [71, 111, 111, 103, 108, 101, 32, -29, -126, -80, // -29, -125, -85, -29, -125, -68, -29, -125, -105] Logger.log(decoded); // If we want a String instead of a byte array: // This logs the original "Google グループ" Logger.log(Utilities.newBlob(decoded).getDataAsString());
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
encoded | String | مصفوفة من وحدات البايت للبيانات الآمنة على الويب لفك الترميز. |
رحلة العودة
Byte[]
: البيانات الأولية التي تمثلها وسيطة أساسية مُشفَّرة على الويب تعتمد على معيار 64 كمصفوفة بايت.
base64DecodeWebSafe(encoded, charset)
يفك تشفير سلسلة مشفّرة محمية بموجب معيار 64 للويب، في مصفوفة بايت بمجموعة رموز معيّنة.
// This is the base64 web-safe encoded form of "Google グループ" var base64data = "R29vZ2xlIOOCsOODq-ODvOODlw=="; var decoded = Utilities.base64DecodeWebSafe(base64data, Utilities.Charset.UTF_8); // This logs: // [71, 111, 111, 103, 108, 101, 32, -29, -126, -80, // -29, -125, -85, -29, -125, -68, -29, -125, -105] Logger.log(decoded); // If we want a String instead of a byte array: // This logs the original "Google グループ" Logger.log(Utilities.newBlob(decoded).getDataAsString());
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
encoded | String | سلسلة البيانات الآمنة على الويب لفك الترميز |
charset | Charset | تمثّل هذه السمة Charset مجموعة من أحرف الإدخال. |
رحلة العودة
Byte[]
: البيانات الأولية التي تمثلها وسيطة أساسية مُشفَّرة على الويب تعتمد على معيار 64 كمصفوفة بايت.
base64Encode(data)
تنشئ سلسلة Base-64 مرمّزة من مصفوفة "بايت". القاعدة 64 هي ترميز شائع ويتم قبوله من خلال مجموعة من الأدوات التي لا يمكنها قبول البيانات الثنائية. تُستخدَم القاعدة 64 عادةً في بروتوكولات الإنترنت، مثل البريد الإلكتروني أو HTTP أو في مستندات XML.
// Instantiates a blob here for clarity var blob = Utilities.newBlob("A string here"); // Writes 'QSBzdHJpbmcgaGVyZQ==' to the log. var encoded = Utilities.base64Encode(blob.getBytes()); Logger.log(encoded);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
data | Byte[] | بايت[] من البيانات لترميزها. |
رحلة العودة
String
— تمثيل مقترَح أساسي بقيمة 64 حرفًا للبيانات التي تم تمريرها.
base64Encode(data)
تنشئ سلسلة مشفّرة Base-64 من السلسلة المحددة. Base 64 هو ترميز شائع مقبول من خلال مجموعة من الأدوات التي لا يمكنها قبول البيانات الثنائية. تُستخدَم القاعدة 64 عادةً في بروتوكولات الإنترنت، مثل البريد الإلكتروني أو HTTP أو في مستندات XML.
// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log. var encoded = Utilities.base64Encode("A string here"); Logger.log(encoded);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
data | String | السلسلة المطلوب ترميزها. |
رحلة العودة
String
— تمثيل تمثيلي أساسي و64 لسلسلة الإدخال.
base64Encode(data, charset)
تنشئ سلسلة Base-64 مرمّزة من السلسلة المحدّدة في مجموعة أحرف محدّدة. مجموعة الأحرف هي طريقة لترميز الأحرف بحيث يمكن ترميزها. ويتم تنفيذ ذلك عادةً بتنسيق ثنائي قد لا يكون متوافقًا بشكل عام مع بروتوكولات معيّنة لنقل البيانات. ولجعل البيانات متوافقة، يتم ترميزها بشكل عام في القاعدة 64، وهي عبارة عن ترميز شائع مقبول من خلال مجموعة من الأدوات التي لا يمكنها قبول البيانات الثنائية. تُستخدَم القاعدة 64 عادةً في بروتوكولات الإنترنت، مثل البريد الإلكتروني أو HTTP أو في مستندات XML.
// "Google Groups" in Katakana (Japanese) var input = "Google グループ"; // Writes "R29vZ2xlIOOCsOODq+ODvOODlw==" to the log var encoded = Utilities.base64Encode(input, Utilities.Charset.UTF_8); Logger.log(encoded);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
data | String | سلسلة البيانات المطلوب ترميزها. |
charset | Charset | تمثّل هذه السمة Charset مجموعة من أحرف الإدخال. |
رحلة العودة
String
: التمثيل الأساسي بترميز 64 لسلسلة الإدخال مع السمة Charset
المحدَّدة.
base64EncodeWebSafe(data)
تنشئ سلسلة أساسية مُشفّرة بالترميز 64 للويب، وتكون صفيفًا من مصفوفة "بايت". تُعدّ القاعدة 64 ترميزًا شائعًا يمكن قبوله من خلال مجموعة من الأدوات التي لا يمكنها قبول البيانات الثنائية. تُستخدَم الخطة الأساسية 64 الآمنة على الويب عادةً في بروتوكولات الإنترنت مثل البريد الإلكتروني أو HTTP أو في مستندات XML.
// Instantiates a blob here for clarity var blob = Utilities.newBlob("A string here"); // Writes 'QSBzdHJpbmcgaGVyZQ==' to the log. var encoded = Utilities.base64EncodeWebSafe(blob.getBytes()); Logger.log(encoded);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
data | Byte[] | مصفوفة من وحدات البايت للبيانات التي يجب ترميزها. |
رحلة العودة
String
: تمثيل مُشفَّر آمن للاستخدام على الويب لمدة 64 عامًا للبيانات التي تم تمريرها في البيانات.
base64EncodeWebSafe(data)
تنشئ سلسلة أساسية مُشفّرة بالتوافق مع الويب 64 من السلسلة المحدّدة. القاعدة 64 هي ترميز شائع ويتم قبوله من خلال مجموعة من الأدوات التي لا يمكنها قبول البيانات الثنائية. تُستخدَم أمان الويب 64 عادةً في بروتوكولات الإنترنت مثل البريد الإلكتروني أو HTTP أو في مستندات XML.
// Writes 'QSBzdHJpbmcgaGVyZQ==' to the log. var encoded = Utilities.base64EncodeWebSafe("A string here"); Logger.log(encoded);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
data | String | السلسلة المطلوب ترميزها. |
رحلة العودة
String
— تمثيل تمثيلي أساسي و64 آمن لسلسلة الإدخال.
base64EncodeWebSafe(data, charset)
تنشئ سلسلة أساسية مُشفّرة بالترميز 64 للويب، من السلسلة المحددة في مجموعة أحرف معيّنة. مجموعة الأحرف هي طريقة لترميز الأحرف بحيث يمكن ترميزها. ويتم ذلك عادةً بتنسيق ثنائي قد لا يكون متوافقًا بشكل عام مع بروتوكولات نقل بيانات معيّنة. لجعل البيانات متوافقة، يتم ترميزها بشكل عام في القاعدة 64، وهي ترميز شائع تقبله مجموعة متنوعة من الأدوات التي لا يمكنها قبول البيانات الثنائية. تُستخدَم الخطة الأساسية 64 الآمنة على الويب عادةً في بروتوكولات الإنترنت مثل البريد الإلكتروني أو HTTP أو في مستندات XML.
// "Google Groups" in Katakana (Japanese) var input = "Google グループ"; // Writes "R29vZ2xlIOOCsOODq-ODvOODlw==" to the log var encoded = Utilities.base64EncodeWebSafe(input, Utilities.Charset.UTF_8); Logger.log(encoded);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
data | String | سلسلة البيانات المطلوب ترميزها. |
charset | Charset | تمثّل هذه السمة Charset مجموعة من أحرف الإدخال. |
رحلة العودة
String
: التمثيل الأساسي المشفّر على الويب والرمز الأساسي 64 لسلسلة الإدخال مع السمة Charset
المحدّدة
computeDigest(algorithm, value)
احسب ملخصًا باستخدام الخوارزمية المحدّدة للقيمة Byte[]
المحدّدة.
var input = Utilities.base64Decode("aW5wdXQgdG8gaGFzaA0K") // == base64encode("input to hash") var digest = Utilities.computeDigest(Utilities.DigestAlgorithm.MD5, input); Logger.log(digest);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
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)
يتم تنسيق التاريخ وفقًا للمواصفات الموضّحة في فئة JSE SE SimpleDateFormat يُرجى الانتقال إلى المواصفات على http://docs.oracle.com/javase/7/docs/api/java/text/SimpleDateFormat.html
// This formats the date as Greenwich Mean Time in the format // year-month-dateThour-minute-second. var formattedDate = Utilities.formatDate(new Date(), "GMT", "yyyy-MM-dd'T'HH:mm:ss'Z'"); Logger.log(formattedDate);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
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
: تمثيل سلسلة المعرّف الفريد العالمي
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 . |
رحلة العودة
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 الذي سيتم إنشاؤه. |
رحلة العودة
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 جديدًا من مصفوفة "بايت" ونوع محتوى. يتم استخدام البيانات الثنائية في العديد من واجهات برمجة تطبيقات "برمجة التطبيقات" والتي تستخدم البيانات الثنائية كإدخال.
// 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 | - يمكن أن يكون نوع الكائن الثنائي الكبير (blob) null . |
name | String | يمكن أن يكون اسم الكائن الثنائي الكبير (blob) null . |
رحلة العودة
Blob
: Blob الذي تم إنشاؤه مؤخرًا
newBlob(data)
إنشاء كائن Blob جديد من سلسلة يتم استخدام البيانات الثنائية في العديد من واجهات برمجة تطبيقات "برمجة التطبيقات" التي تستخدم البيانات الثنائية كإدخال.
// Declares a string for the blob. const data = 'GOOGLE'; // Creates a blob object from a string. const blob = Utilities.newBlob(data); // Logs the blob data in byte array to the console. console.log('Blob Data:', blob.getBytes());
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
data | String | سلسلة الكائن الثنائي الكبير (blob) التي يُفترض أنّها UTF-8. |
رحلة العودة
Blob
: Blob الذي تم إنشاؤه مؤخرًا
newBlob(data, contentType)
إنشاء كائن Blob جديد من سلسلة ونوع محتوى يتم استخدام البيانات الثنائية في العديد من واجهات برمجة تطبيقات "برمجة التطبيقات" والتي تستخدم البيانات الثنائية كإدخال.
// Declares a string for the blob. const data = 'GOOGLE'; // Declares the content type of blob. const contentType = 'application/json'; // Creates a blob object from the string and content type. const blob = Utilities.newBlob(data, contentType); // Logs the blob data in byte array to the console. console.log('Blob data:', blob.getBytes()); // Logs the content type of the blob to the console. console.log(blob.getContentType());
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
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 | يمكن أن يكون اسم الكائن الثنائي الكبير (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);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
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)
بيانات السكون لعدد محدد من الملي ثانية يمكنك إدخال النص البرمجي فورًا في وضع السكون لعدد محدد من الملي ثانية. الحد الأقصى للقيمة المسموح بها هو 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
يحتوي على البيانات غير المضغوطة.
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 للبيانات المضغوطة |
رحلة العودة
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) |
رحلة العودة
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
: كائن جديد يحتوي على الإدخالات كأرشيف