این سرویس به اسکریپت ها اجازه می دهد تا با واکشی URL ها به منابع دیگر در وب دسترسی پیدا کنند. یک اسکریپت می تواند از سرویس UrlFetch برای صدور درخواست های HTTP و HTTPS و دریافت پاسخ ها استفاده کند. سرویس UrlFetch از زیرساخت شبکه Google برای مقاصد کارایی و مقیاس‌بندی استفاده می‌کند.
درخواست های ارائه شده با استفاده از این سرویس از مجموعه ای از محدوده های IP سرچشمه می گیرند. در صورت نیاز به لیست سفید یا تأیید این درخواست‌ها، می‌توانید فهرست کامل آدرس‌های IP را جستجو کنید .
این سرویس به محدوده https://www.googleapis.com/auth/script.external_request نیاز دارد. در بیشتر موارد Apps Script به طور خودکار محدوده‌هایی را که یک اسکریپت نیاز دارد شناسایی کرده و شامل می‌شود، اما اگر محدوده‌های خود را صریحاً تنظیم می‌کنید، باید به صورت دستی این محدوده را برای استفاده از UrlFetchApp اضافه کنید.
همچنین ببینید
کلاس ها
| نام | توضیح مختصر |
|---|---|
HTTPResponse | این کلاس به کاربران اجازه می دهد تا به اطلاعات خاصی در مورد پاسخ های HTTP دسترسی داشته باشند. |
UrlFetchApp | منابع را واکشی کنید و با میزبان های دیگر از طریق اینترنت ارتباط برقرار کنید. |
HTTPResponse
مواد و روش ها
| روش | نوع برگشت | توضیح مختصر |
|---|---|---|
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 را دریافت کنید. |
UrlFetchApp
مواد و روش ها
| روش | نوع برگشت | توضیح مختصر |
|---|---|---|
fetch(url) | HTTPResponse | درخواستی برای واکشی URL می دهد. |
fetch(url, params) | HTTPResponse | درخواستی برای واکشی URL با استفاده از پارامترهای پیشرفته اختیاری می کند. |
fetchAll(requests) | HTTPResponse[] | چندین درخواست برای واکشی چندین URL با استفاده از پارامترهای پیشرفته اختیاری می کند. |
getRequest(url) | Object | درخواستی را که در صورت فراخوانی عملیات انجام شده است، برمی گرداند. |
getRequest(url, params) | Object | درخواستی را که در صورت فراخوانی عملیات انجام می شود، برمی گرداند. |