این سرویس به اسکریپتها اجازه میدهد تا با دریافت URLها به منابع دیگر در وب دسترسی پیدا کنند. یک اسکریپت میتواند از سرویس UrlFetch برای صدور درخواستهای HTTP و HTTPS و دریافت پاسخها استفاده کند. سرویس UrlFetch از زیرساخت شبکه گوگل برای اهداف کارایی و مقیاسپذیری استفاده میکند.
درخواستهای ارسالی با استفاده از این سرویس از مجموعهای از محدودههای 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 | دادههای درون این شیء را به صورت یک 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 را دریافت کنید. |
UrlFetchApp
روشها
| روش | نوع بازگشتی | شرح مختصر |
|---|---|---|
fetch(url) | HTTPResponse | درخواستی برای دریافت یک URL ارسال میکند. |
fetch(url, params) | HTTPResponse | با استفاده از پارامترهای پیشرفته اختیاری، درخواستی برای دریافت یک URL ارسال میکند. |
fetch All(requests) | HTTPResponse[] | با استفاده از پارامترهای پیشرفته اختیاری، چندین درخواست برای دریافت چندین URL ارسال میکند. |
get Request(url) | Object | درخواستی را که در صورت فراخوانی عملیات انجام شده است، برمیگرداند. |
get Request(url, params) | Object | درخواستی را که در صورت فراخوانی عملیات انجام میشود، برمیگرداند. |