Class HTTPResponse

HTTPResponse

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

يمكن أيضًا مراجعة

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
getAllHeaders()Objectتعرض خريطة السمات/القيم للعناوين لاستجابة HTTP، مع العناوين التي تتضمّن قيمًا متعددة يتم عرضها على شكل مصفوفات.
getAs(contentType)Blobعرض البيانات داخل هذا الكائن على شكل كائن ثنائي كبير يتم تحويله إلى نوع المحتوى المحدّد.
getBlob()Blobعرض البيانات داخل هذا الكائن على هيئة كائن ثنائي كبير (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.
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 التي تم إنشاؤها حديثًا لحصص أكثر صرامة مؤقتًا.

المَعلمات

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

استرجاع الكرة

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

getBlob()

عرض البيانات داخل هذا الكائن على هيئة كائن ثنائي كبير (blob).

استرجاع الكرة

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"));

المَعلمات

الاسمTypeالوصف
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 لـ 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.
var response = UrlFetchApp.fetch("http://www.google.com/");
Logger.log(response.getResponseCode());

استرجاع الكرة

Integer: رمز استجابة HTTP (مثل 200 لـ OK)