Class HTTPResponse

HTTPResponse

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

انظر أيضًا

• UrlFetchApp

الطُرق

الطريقة	نوع القيمة التي يتم إرجاعها	وصف قصير
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 لـ OK، وما إلى ذلك) لاستجابة HTTP

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

getAllHeaders()

تعرض هذه الدالة خريطة سمة/قيمة للعناوين الخاصة باستجابة HTTP، مع عرض العناوين التي تتضمّن قيمًا متعددة كصفائف.

// The code below logs the HTTP headers from the response
// received when fetching the Google home page.
const 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 التي تم إنشاؤها حديثًا لحصص أكثر صرامة بشكل مؤقت.

المعلمات

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

الإرجاع

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

---

getBlob()

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

الإرجاع

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

---

getContent()

تعرض هذه السمة المحتوى الثنائي الأولي لاستجابة HTTP.

// The code below logs the value of the first byte of the Google home page.
const 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.
const 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.
const response = UrlFetchApp.fetch('http://www.google.com/');
Logger.log(response.getContentText('UTF-8'));

المعلمات

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

الإرجاع

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

---

getHeaders()

تعرض هذه السمة خريطة سمة/قيمة للعناوين الخاصة باستجابة HTTP.

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

الإرجاع

‫Object: خريطة مفتاح/قيمة بلغة JavaScript لعناوين HTTP

---

getResponseCode()

الحصول على رمز حالة HTTP (200 لـ 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.
const response = UrlFetchApp.fetch('http://www.google.com/');
Logger.log(response.getResponseCode());

الإرجاع

Integer: رمز استجابة HTTP (مثلاً، 200 في حال OK).