Class HTTPResponse

HTTPResponse

הכיתה הזו מאפשרת למשתמשים לגשת למידע ספציפי בתגובות HTTP.

ראה גם

• UrlFetchApp

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.

תיעוד מפורט

getAllHeaders()

הפונקציה מחזירה מיפוי של כותרות לתגובת HTTP, כאשר כותרות עם כמה ערכים מוחזרות כמערכים.

// The code below logs the HTTP headers from the response
// received when fetching the Google home page.
const response = UrlFetchApp.fetch('http://www.google.com/');
Logger.log(response.getAllHeaders());

חזרה

‫Object — מפה של כותרות HTTP בפורמט JavaScript של מפתח/ערך.

---

getAs(contentType)

החזרת הנתונים בתוך האובייקט הזה כ-Blob שהומר לסוג התוכן שצוין. בשיטה הזו, הסיומת המתאימה מתווספת לשם הקובץ – לדוגמה, 'myfile.pdf'. עם זאת, המערכת מניחה שהחלק של שם הקובץ שאחרי הנקודה האחרונה (אם יש כזו) הוא סיומת קיימת שצריך להחליף. לכן, השם ShoppingList.12.25.2014 הופך ל-ShoppingList.12.25.pdf.

כדי לראות את המכסות היומיות להמרות, אפשר לעיין במאמר בנושא מכסות לשירותי Google. יכול להיות שדומיינים חדשים ב-Google Workspace יהיו כפופים באופן זמני למכסות מחמירות יותר.

פרמטרים

שם	סוג	תיאור
contentType	String	סוג ה-MIME שאליו רוצים להמיר. ברוב ה-blob, ‏ 'application/pdf' היא האפשרות התקפה היחידה. אם התמונות בפורמט BMP,‏ GIF,‏ JPEG או PNG, אפשר להשתמש גם באחד מהערכים 'image/bmp', 'image/gif', 'image/jpeg' או 'image/png'. במסמך Google Docs, הערך 'text/markdown' תקף גם כן.

חזרה

‫Blob — הנתונים כ-blob.

---

getBlob()

החזרת הנתונים בתוך האובייקט הזה כ-blob.

חזרה

‫Blob — הנתונים כ-blob.

---

getContent()

קבלת תוכן בינארי גולמי של תגובת HTTP.

// The code below logs the value of the first byte of the Google home page.
const 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.
const 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.
const 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.
const response = UrlFetchApp.fetch('http://www.google.com/');
Logger.log(response.getHeaders());

חזרה

‫Object — מפה של כותרות HTTP בפורמט JavaScript של מפתח/ערך.

---

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.
const response = UrlFetchApp.fetch('http://www.google.com/');
Logger.log(response.getResponseCode());

חזרה

‫Integer – קוד תגובת ה-HTTP (לדוגמה, 200 אם התגובה היא OK).