דף זה תורגם על ידי Cloud Translation API.

Class 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 – מפה של מפתח/ערך ב-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'`. במסמך ב-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 – מפה של מפתח/ערך ב-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)