שיטות
שיטה | סוג הערך המוחזר | תיאור קצר |
---|---|---|
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 שהומר לסוג התוכן שצוין. הזה method מוסיפה את הסיומת המתאימה לשם הקובץ, לדוגמה, "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' צריך להיות תואם גם
תקין. במסמך של Google Docs, גם 'text/markdown' תקף. |
חזרה
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 | מחרוזת שמייצגת את ה-charset שיש להשתמש בו לקידוד של תגובת ה-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 לתקין)