Class HTTPResponse

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
HTTPResponse

تتيح هذه الفئة للمستخدمين الوصول إلى معلومات محددة على استجابات HTTP.

راجع أيضًا

الطُرق

الطريقةنوع الإرجاعوصف قصير
getAllHeaders()Objectتعرض ربط السمة/القيمة لاستجابة HTTP، مع تضمين القيم التي تحتوي على قيم متعددة في شكل مصفوفات.
getAs(contentType)Blobعرض البيانات داخل هذا العنصر ككائن ثنائي كبير (blob) تم تحويله إلى نوع المحتوى المحدد.
getBlob()Blobعرض البيانات داخل هذا الكائن كائن ثنائي كبير.
getContent()Byte[]للحصول على المحتوى الثنائي الأولي لاستجابة HTTP.
getContentText()Stringتعمل هذه الميزة على ترميز محتوى استجابة HTTP كسلسلة بيانات.
getContentText(charset)Stringتعرض محتوى استجابة HTTP مشفّرة كسلسلة من مجموعة أحرف محددة.
getHeaders()Objectتعرِض خريطة السمة/القيمة لاستجابة HTTP.
getResponseCode()Integerالحصول على رمز حالة HTTP (200 for OK، إلخ) لاستجابة HTTP.

المستندات التفصيلية

getAllHeaders()

تعرض ربط السمة/القيمة لاستجابة HTTP، مع تضمين القيم التي تحتوي على قيم متعددة في شكل مصفوفات.

// The code below logs the HTTP headers from the response
// received when fetching the Google home page.
var response = UrlFetchApp.fetch("http://www.google.com/");
Logger.log(response.getAllHeaders());

تذكرة ذهاب وعودة

Object - خريطة مفتاح/قيمة JavaScript لرؤوس HTTP


getAs(contentType)

عرض البيانات داخل هذا العنصر ككائن ثنائي كبير (blob) تم تحويله إلى نوع المحتوى المحدد. تضيف هذه الطريقة الامتداد المناسب إلى اسم الملف، على سبيل المثال، "myfile.pdf". ومع ذلك، يفترض أنّ الجزء من اسم الملف الذي يتبع النقطة الأخيرة (إن وجد) هو إضافة حالية يجب استبدالها. نتيجةً لذلك، يصبح "ShoppingList.12.25.2014" "ShoppingList.12.25.pdf".

لعرض الحصص اليومية للإحالات الناجحة، يُرجى الاطّلاع على حصص خدمات Google. قد تخضع نطاقات Google Workspace التي تم إنشاؤها حديثًا إلى عروض أسعار أكثر صرامة.

المعلّمات

الاسمالنوعالوصف
contentTypeStringنوع MIME المطلوب التحويل إليه. وبالنسبة إلى معظم الكائنات الثنائية الكبيرة، 'application/pdf' هو الخيار الوحيد الصالح. بالنسبة إلى الصور بتنسيق BMP أو GIF أو JPEG أو PNG، أي من القيم 'image/bmp' أو 'image/gif' أو 'image/jpeg' أو 'image/png' صالح أيضًا.

تذكرة ذهاب وعودة

Blob — البيانات كائن ثنائي كبير.


getBlob()

عرض البيانات داخل هذا الكائن كائن ثنائي كبير.

تذكرة ذهاب وعودة

Blob — البيانات كائن ثنائي كبير.


getContent()

للحصول على المحتوى الثنائي الأولي لاستجابة HTTP.

// The code below logs the value of the first byte of the Google home page.
var response = UrlFetchApp.fetch("http://www.google.com/");
Logger.log(response.getContent()[0]);

تذكرة ذهاب وعودة

Byte[] - المحتوى كمصفوفة ثنائية أساسية


getContentText()

تعمل هذه الميزة على ترميز محتوى استجابة HTTP كسلسلة بيانات.

// The code below logs the HTML code of the Google home page.
var response = UrlFetchApp.fetch("http://www.google.com/");
Logger.log(response.getContentText());

تذكرة ذهاب وعودة

String - محتوى استجابة HTTP، كسلسلة


getContentText(charset)

تعرض محتوى استجابة HTTP مشفّرة كسلسلة من مجموعة أحرف محددة.

// The code below logs the HTML code of the Google home page with the UTF-8 charset.
var response = UrlFetchApp.fetch("http://www.google.com/");
Logger.log(response.getContentText("UTF-8"));

المعلّمات

الاسمالنوعالوصف
charsetStringسلسلة تمثّل مجموعة الأحرف التي سيتم استخدامها لترميز محتوى استجابة HTTP

تذكرة ذهاب وعودة

String — محتوى استجابة HTTP، الذي تم ترميزه باستخدام مجموعة الأحرف المحدّدة


getHeaders()

تعرِض خريطة السمة/القيمة لاستجابة HTTP.

// The code below logs the HTTP headers from the response
// received when fetching the Google home page.
var response = UrlFetchApp.fetch("http://www.google.com/");
Logger.log(response.getHeaders());

تذكرة ذهاب وعودة

Object - خريطة مفتاح/قيمة JavaScript لرؤوس HTTP


getResponseCode()

الحصول على رمز حالة HTTP (200 for OK، إلخ) لاستجابة HTTP.

// The code below logs the HTTP status code from the response received
// when fetching the Google home page.
// It should be 200 if the request succeeded.
var response = UrlFetchApp.fetch("http://www.google.com/");
Logger.log(response.getResponseCode());

تذكرة ذهاب وعودة

Integer — رمز استجابة HTTP (على سبيل المثال، 200 للموافقة)