Class HTTPResponse

HTTPResponse

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

انظر أيضًا

الطُرق

الطريقةنوع الإرجاعوصف قصير
getAllHeaders()Objectتعرض خريطة سمة/قيم للعناوين لاستجابة HTTP، مع عناوين تحتوي على يتم إرجاع قيم متعددة كصفائف.
getAs(contentType)Blobعرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير تم تحويله إلى نوع المحتوى المحدّد.
getBlob()Blobعرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير.
getContent()Byte[]الحصول على المحتوى الثنائي الأولي لاستجابة HTTP.
getContentText()Stringالحصول على محتوى استجابة HTTP تم ترميزها كسلسلة.
getContentText(charset)Stringلعرض محتوى استجابة HTTP مشفرة كسلسلة من مجموعة الأحرف المحددة.
getHeaders()Objectتعرض خريطة سمة/قيم للعناوين لاستجابة HTTP.
getResponseCode()Integerالحصول على رمز حالة HTTP (200 لعبارة "حسنًا"، وما إلى ذلك) لاستجابة 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)

عرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير تم تحويله إلى نوع المحتوى المحدّد. هذا النمط تضيف الامتداد المناسب لاسم الملف — على سبيل المثال، "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' صالحة. بالنسبة إلى مستند "مستندات Google"، يُعدّ 'text/markdown' أيضًا صالحًا.

الإرجاع

Blob — البيانات ككائنات ثنائية كبيرة (blob).

getBlob()

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

الإرجاع

Blob — البيانات ككائنات ثنائية كبيرة (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 لعبارة "حسنًا"، وما إلى ذلك) لاستجابة 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 لعبارة "حسنًا")