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).