این سرویس به اسکریپت ها اجازه می دهد تا با واکشی URL ها به منابع دیگر در وب دسترسی پیدا کنند. یک اسکریپت می تواند از سرویس UrlFetch برای صدور درخواست های HTTP و HTTPS و دریافت پاسخ ها استفاده کند. سرویس UrlFetch از زیرساخت شبکه Google برای مقاصد کارایی و مقیاس‌بندی استفاده می‌کند.
درخواست های ارائه شده با استفاده از این سرویس از مجموعه ای از محدوده های IP سرچشمه می گیرند. در صورت نیاز به لیست سفید یا تأیید این درخواست‌ها، می‌توانید فهرست کامل آدرس‌های IP را جستجو کنید .
رشته عامل پیش‌فرض کاربر درخواست‌های سرویس UrlFetch Mozilla/5.0 (compatible; Google-Apps-Script; beanserver; +https://script.google.com; id: SCRIPT_ID ) .
این سرویس به محدوده https://www.googleapis.com/auth/script.external_request نیاز دارد. در بیشتر موارد Apps Script به طور خودکار محدوده‌هایی را که یک اسکریپت نیاز دارد شناسایی کرده و شامل می‌شود، اما اگر محدوده‌های خود را به طور صریح تنظیم می‌کنید، باید به صورت دستی این محدوده را اضافه کنید تا Url Fetch App استفاده کنید.
همچنین ببینید
کلاس ها
| نام | شرح مختصر |
|---|---|
HTTPResponse | این کلاس به کاربران اجازه می دهد تا به اطلاعات خاصی در مورد پاسخ های HTTP دسترسی داشته باشند. |
Url Fetch App | منابع را واکشی کنید و با میزبان های دیگر از طریق اینترنت ارتباط برقرار کنید. |
HTTPResponse
روش ها
| روش | نوع برگشت | شرح مختصر |
|---|---|---|
get All Headers() | Object | نقشه ویژگی/مقدار سرصفحه‌ها را برای پاسخ HTTP، با سرصفحه‌هایی که مقادیر متعددی به‌عنوان آرایه برگردانده شده‌اند، برمی‌گرداند. |
get As(contentType) | Blob | داده های داخل این شی را به عنوان یک حباب تبدیل به نوع محتوای مشخص شده برگردانید. |
get 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 برای OK و غیره) یک پاسخ HTTP را دریافت کنید. |
Url Fetch App
روش ها
| روش | نوع برگشت | شرح مختصر |
|---|---|---|
fetch(url) | HTTPResponse | درخواستی برای واکشی URL می دهد. |
fetch(url, params) | HTTPResponse | درخواستی برای واکشی URL با استفاده از پارامترهای پیشرفته اختیاری می کند. |
fetch All(requests) | HTTPResponse[] | چندین درخواست برای واکشی چندین URL با استفاده از پارامترهای پیشرفته اختیاری می کند. |
get Request(url) | Object | درخواستی را که در صورت فراخوانی عملیات انجام شده است، برمی گرداند. |
get Request(url, params) | Object | درخواستی را که در صورت فراخوانی عملیات انجام می شود، برمی گرداند. |