Class HTTPResponse

پاسخ HTTP

این کلاس به کاربران اجازه می‌دهد تا به اطلاعات خاصی در مورد پاسخ‌های HTTP دسترسی داشته باشند.

همچنین ببینید

روش‌ها

روش نوع بازگشتی شرح مختصر
get All Headers() Object یک نقشه ویژگی/مقدار از هدرها را برای پاسخ HTTP برمی‌گرداند، که هدرهایی که چندین مقدار دارند به صورت آرایه برگردانده می‌شوند.
get As(contentType) Blob داده‌های درون این شیء را به صورت یک blob تبدیل‌شده به نوع محتوای مشخص‌شده، برمی‌گرداند.
get Blob() Blob داده‌های درون این شیء را به صورت یک blob برمی‌گرداند.
get Content() Byte[] محتوای باینری خام یک پاسخ HTTP را دریافت می‌کند.
get Content Text() String محتوای یک پاسخ HTTP را که به صورت یک رشته کدگذاری شده است، دریافت می‌کند.
get Content Text(charset) String محتوای یک پاسخ HTTP که به صورت رشته‌ای از مجموعه کاراکترهای داده شده کدگذاری شده است را برمی‌گرداند.
get Headers() Object یک نقشه ویژگی/مقدار از هدرهای پاسخ HTTP را برمی‌گرداند.
get Response Code() Integer کد وضعیت HTTP (200 برای تأیید و غیره) یک پاسخ HTTP را دریافت کنید.

مستندات دقیق

get All Headers()

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

get As(contentType)

داده‌های درون این شیء را به صورت یک blob تبدیل‌شده به نوع محتوای مشخص‌شده برمی‌گرداند. این متد پسوند مناسب را به نام فایل اضافه می‌کند - برای مثال، "myfile.pdf". با این حال، فرض می‌کند که بخشی از نام فایل که پس از آخرین نقطه (در صورت وجود) می‌آید، یک پسوند موجود است که باید جایگزین شود. در نتیجه، "ShoppingList.12.25.2014" به "ShoppingList.12.25.pdf" تبدیل می‌شود.

برای مشاهده سهمیه‌های روزانه برای تبدیل‌ها، به سهمیه‌های سرویس‌های گوگل مراجعه کنید. دامنه‌های جدید Google Workspace ممکن است موقتاً مشمول سهمیه‌های سختگیرانه‌تری باشند.

پارامترها

نام نوع توضیحات
content Type String نوع MIME برای تبدیل. برای اکثر blobها، 'application/pdf' تنها گزینه معتبر است. برای تصاویر با فرمت BMP، GIF، JPEG یا PNG، هر یک از 'image/bmp' ، 'image/gif' ، 'image/jpeg' یا 'image/png' نیز معتبر هستند. برای یک سند Google Docs، 'text/markdown' نیز معتبر است.

بازگشت

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

get Blob()

داده‌های درون این شیء را به صورت یک blob برمی‌گرداند.

بازگشت

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

get Content()

محتوای باینری خام یک پاسخ 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[] — محتوا به عنوان یک آرایه دودویی خام.

get Content Text()

محتوای یک پاسخ 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، به صورت یک رشته.

get Content Text(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، که با استفاده از مجموعه کاراکتر داده شده کدگذاری شده است.

get Headers()

یک نقشه ویژگی/مقدار از هدرهای پاسخ 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 - یک نقشه کلید/مقدار جاوا اسکریپت از هدرهای HTTP.

get Response Code()

کد وضعیت 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 برای OK).