שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
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. |
תיעוד מפורט
getAllHeaders()
מחזירה מפת מאפיינים/ערכים של כותרות עבור תגובת ה-HTTP, עם כותרות שיש להן מספר ערכים שהוחזרו כמערכים.
// The code below logs the HTTP headers from the response // received when fetching the Google home page. var response = UrlFetchApp.fetch("http://www.google.com/"); Logger.log(response.getAllHeaders());
החזרות
Object
- מפת מפתח/ערך של JavaScript של כותרות HTTP
getAs(contentType)
החזרת הנתונים שבתוך האובייקט הזה כ-blob שהומר לסוג התוכן שצוין. השיטה הזו מוסיפה את הסיומת המתאימה לשם הקובץ, לדוגמה, 'myfile.pdf'. עם זאת, ההנחה היא שהחלק שמופיע בשם הקובץ אחרי הנקודה האחרונה (אם יש כזה) הוא תוסף קיים שצריך להחליף. בעקבות זאת, הערך "ShoppingList.12.25.2014" הופך ל-"ShoppingList.12.25.pdf".
במאמר מכסות לשירותי Google תוכלו לראות את המכסות היומיות להמרות. באופן זמני, דומיינים חדשים ב-Google Workspace עשויים להיות כפופים למכסות מחמירות יותר.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
contentType | String | סוג ה-MIME שאליו יש להמיר. ברוב ה-blobs, 'application/pdf' היא
האפשרות החוקית היחידה. עבור תמונות בפורמט BMP, GIF, JPEG או PNG, ניתן גם להשתמש בכל אחד מהערכים 'image/bmp' , 'image/gif' , 'image/jpeg' או 'image/png' . |
החזרות
Blob
– הנתונים כ-blob.
getBlob()
getContent()
הפונקציה מקבלת את התוכן הבינארי הגולמי של תגובת HTTP.
// The code below logs the value of the first byte of the Google home page. var response = UrlFetchApp.fetch("http://www.google.com/"); Logger.log(response.getContent()[0]);
החזרות
Byte[]
– התוכן כמערך בינארי גולמי
getContentText()
מחזירה את התוכן של תגובת HTTP בקידוד של מחרוזת.
// The code below logs the HTML code of the Google home page. var response = UrlFetchApp.fetch("http://www.google.com/"); Logger.log(response.getContentText());
החזרות
String
- התוכן של תגובת ה-HTTP, כמחרוזת
getContentText(charset)
מחזירה את התוכן של תגובת HTTP שמקודדת כמחרוזת של ערכת התווים הנתונה.
// The code below logs the HTML code of the Google home page with the UTF-8 charset. var response = UrlFetchApp.fetch("http://www.google.com/"); Logger.log(response.getContentText("UTF-8"));
פרמטרים
שם | תיאור | התיאור |
---|---|---|
charset | String | מחרוזת המייצגת את ערכת התווים שתשמש לקידוד התוכן של תגובת HTTP |
החזרות
String
- התוכן של תגובת ה-HTTP, המקודד באמצעות מערכת התווים הנתונה
getHeaders()
מחזירה מפת מאפיינים/ערכים של כותרות עבור תגובת HTTP.
// The code below logs the HTTP headers from the response // received when fetching the Google home page. var response = UrlFetchApp.fetch("http://www.google.com/"); Logger.log(response.getHeaders());
החזרות
Object
- מפת מפתח/ערך של JavaScript של כותרות HTTP
getResponseCode()
קבל את קוד מצב ה-HTTP (200 עבור OK וכן הלאה) של תגובת HTTP.
// The code below logs the HTTP status code from the response received // when fetching the Google home page. // It should be 200 if the request succeeded. var response = UrlFetchApp.fetch("http://www.google.com/"); Logger.log(response.getResponseCode());
החזרות
Integer
– קוד תגובת HTTP (לדוגמה 200 לאישור)