Class HTTPResponse

پاسخ HTTPR

این کلاس به کاربران اجازه می دهد تا به اطلاعات خاصی در مورد پاسخ های 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.
var response = UrlFetchApp.fetch("http://www.google.com/");
Logger.log(response.getAllHeaders());

برگشت

Object - یک نقشه کلید/مقدار جاوا اسکریپت از هدرهای 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' نیز معتبر هستند.

برگشت

Blob - داده ها به عنوان یک لکه.

getBlob()

داده های داخل این شی را به صورت حباب برگردانید.

برگشت

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

مولفه های

نام تایپ کنید شرح
charset String رشته ای که نشان دهنده مجموعه نویسه برای کدگذاری محتوای پاسخ 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 - یک نقشه کلید/مقدار جاوا اسکریپت از هدرهای 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)