URL Fetch Service

URL Fetch

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