URL Fetch Service

אחזור כתובות URL

השירות הזה מאפשר לסקריפטים לגשת למשאבים אחרים באינטרנט על ידי אחזור כתובות URL. סקריפט יכול להשתמש בשירות UrlFetch כדי ליצור בקשות HTTP ו-HTTPS ולקבל תגובות. שירות UrlFetch משתמש בתשתית הרשת של Google למטרות יעילות והתאמה לעומס (scaling).

בקשות שמבוצעות באמצעות השירות הזה מגיעות ממאגר מוגדר של טווחי IP. אם אתם צריכים לאשר את הבקשות האלה או להוסיף אותן לרשימת ההיתרים, תוכלו לחפש את הרשימה המלאה של כתובות ה-IP.

לשירות הזה נדרש ההיקף https://www.googleapis.com/auth/script.external_request. ברוב המקרים Apps Script מזהה את ההיקפים שדרושים לסקריפט וכוללים אותם באופן אוטומטי, אבל אם אתם מגדירים את ההיקפים באופן מפורש, צריך להוסיף את ההיקף הזה ידנית כדי להשתמש ב-UrlFetchApp.

כדאי לעיין גם בפרטים הבאים

מחלקות

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

HTTPResponse

שיטות

שיטהסוג הערך שמוחזרתיאור קצר
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

שיטות

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