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