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 لـ 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 التي تم إنشاؤها حديثًا لحصص أكثر صرامة بشكل مؤقت.

المعلمات

الاسمالنوعالوصف
contentTypeStringنوع 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'));

المعلمات

الاسمالنوعالوصف
charsetStringسلسلة تمثّل مجموعة الأحرف التي سيتم استخدامها لترميز محتوى استجابة 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).