این کلاس به کاربران اجازه می دهد تا به اطلاعات خاصی در مورد پاسخ های 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' نیز معتبر هستند. برای سند Google Docs، 'text/markdown' نیز معتبر است. |
بازگشت
Blob
- داده ها به عنوان یک لکه.
getBlob()
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)