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).