דף זה תורגם על ידי Cloud Translation API.

URL Fetch Service

השירות הזה מאפשר לסקריפטים לגשת למשאבים אחרים באינטרנט על ידי אחזור של כתובות 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 מזהה באופן אוטומטי את ההיקפים הנדרשים לסקריפט וכוללת אותם, אבל אם מגדירים את ההיקפים באופן מפורש, צריך להוסיף את ההיקף הזה באופן ידני כדי להשתמש ב-UrlFetchApp.

ראה גם

שיעורים

שם	תיאור קצר
`HTTPResponse`	הכיתה הזו מאפשרת למשתמשים לגשת למידע ספציפי על תגובות HTTP.
`UrlFetchApp`	אחזור משאבים ותקשורת עם מארחים אחרים באינטרנט.

`HTTPResponse`

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
`getAllHeaders()`	`Object`	הפונקציה מחזירה מפה של מאפיינים/ערכים של כותרות לתגובת ה-HTTP, כאשר כותרות עם מספר ערכים מוחזרות כמערכים.
`getAs(contentType)`	`Blob`	החזרת הנתונים שבתוך האובייקט הזה כ-blob שהומר לסוג התוכן שצוין.
`getBlob()`	`Blob`	החזרת הנתונים שבתוך האובייקט הזה כ-blob.
`getContent()`	`Byte[]`	הפונקציה מקבלת את התוכן הבינארי הגולמי של תגובת HTTP.
`getContentText()`	`String`	הפונקציה מקבלת את התוכן של תגובת HTTP שמקודדת כמחרוזת.
`getContentText(charset)`	`String`	הפונקציה מחזירה את התוכן של תגובת HTTP שקודדה כמחרוזת של קוד האותיות שצוין.
`getHeaders()`	`Object`	הפונקציה מחזירה מפה של מאפיינים/ערכים של כותרות לתגובת ה-HTTP.
`getResponseCode()`	`Integer`	אחזור של קוד הסטטוס של HTTP (200 ל-OK וכו') בתגובה של HTTP.

`UrlFetchApp`

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
`fetch(url)`	`HTTPResponse`	שליחת בקשה לאחזור כתובת URL.
`fetch(url, params)`	`HTTPResponse`	שליחת בקשה לאחזור כתובת URL באמצעות פרמטרים מתקדמים אופציונליים.
`fetchAll(requests)`	`HTTPResponse[]`	שליחת מספר בקשות לאחזור מספר כתובות URL באמצעות פרמטרים מתקדמים אופציונליים.
`getRequest(url)`	`Object`	הפונקציה מחזירה את הבקשה שנשלחת אם הפעולה הופעל.
`getRequest(url, params)`	`Object`	הפונקציה מחזירה את הבקשה שנשלחת אם הפעולה מופעלת.