Class HTTPResponse

HTTPResponse

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

ראה גם

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 – מפה של מפתח/ערך ב-JavaScript של כותרות HTTP

getAs(contentType)

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

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

פרמטרים

שםסוגתיאור
contentTypeStringסוג ה-MIME שאליו רוצים להמיר. ברוב ה-blobs, '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'));

פרמטרים

שםסוגתיאור
charsetStringמחרוזת שמייצגת את קוד האותיות שישמש לקידוד התוכן של תגובת ה-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 – מפה של מפתח/ערך ב-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.
const response = UrlFetchApp.fetch('http://www.google.com/');
Logger.log(response.getResponseCode());

חזרה

Integer — קוד תגובת HTTP (למשל, 200 לסטטוס OK)