تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class 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 للإشارة إلى أنّه بحالة جيدة وما إلى ذلك) لاستجابة 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 للإشارة إلى أنّه بحالة جيدة وما إلى ذلك) لاستجابة 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 للإشارة إلى أنّه "حسنًا")