Class Attachment

קובץ מצורף

הוצא משימוש. המחלקה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

קובץ מצורף של Google Sites, כמו קובץ שמצורף לדף.

חשוב לשים לב שקובץ מצורף הוא חלק מ-Blob וניתן להשתמש בו בכל מקום שבו נדרש קלט USD.

var filesPage = SitesApp.getSite('example.com', 'mysite').getChildByName("files");
var attachments = filesPage.getAttachments();

// DocsList.createFile accepts a blob input. Since an Attachment is just a blob, we can
// just pass it directly to that method
var file = DocsList.createFile(attachments[0]);

שיטות

שיטה	סוג הערך שמוחזר	תיאור קצר
getAs(contentType)	Blob	החזרת הנתונים שבתוך האובייקט הזה כ-blob שהומר לסוג התוכן שצוין.
getBlob()	Blob	החזרת הנתונים שבתוך האובייקט הזה כ-blob.

שיטות שהוצאו משימוש

שיטה	סוג הערך שמוחזר	תיאור קצר
deleteAttachment()	void	מחיקת הקובץ המצורף.
getAttachmentType()	AttachmentType	החזרת סוג הקובץ המצורף (HOSTED או WEB).
getContentType()	String	החזר את סוג ה-MIME של הקובץ המצורף.
getDatePublished()	Date	החזרת התאריך שבו הקובץ המצורף פורסם לראשונה.
getDescription()	String	החזר את התיאור של הקובץ המצורף.
getLastUpdated()	Date	החזרת התאריך שבו הקובץ המצורף עודכן לאחרונה.
getParent()	Page	הורדת דף ההורה של הקובץ המצורף.
getTitle()	String	החזר את הכותרת של הקובץ המצורף.
getUrl()	String	החזרת כתובת ה-URL להורדה של הקובץ המצורף.
setContentType(contentType)	Attachment	הגדרת סוג ה-MIME של הקובץ המצורף.
setDescription(description)	Attachment	יש להגדיר את התיאור של הקובץ המצורף.
setFrom(blob)	Attachment	עליך להגדיר את הנתונים עצמם של הקובץ המצורף.
setParent(parent)	Attachment	הגדרת דף ההורה של הקובץ המצורף.
setTitle(title)	Attachment	כאן אפשר להגדיר כותרת לקובץ המצורף.
setUrl(url)	Attachment	מגדיר את כתובת ה-URL להורדה של הקובץ המצורף.

תיעוד מפורט

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

החזרות

Blob – הנתונים כ-blob.

---

getBlob()

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

החזרות

Blob – הנתונים כ-blob.

שיטות שהוצאו משימוש

deleteAttachment()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

מחיקת הקובץ המצורף.

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();
attachments[0].deleteAttachment();

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• https://sites.google.com/feeds

---

getAttachmentType()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

החזרת סוג הקובץ המצורף (HOSTED או WEB).

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();
var attType = attachments[0].getAttachmentType();

// This will log "Hosted"
Logger.log(attType);

// Since this returns an AttachmentType and not a String, for the
// purposes of equivalence we want to either do this or cast the
// type to a String
if(attType ==  SitesService.AttachmentType.HOSTED) {
  Logger.log("This is a match");
}

// The above is the same as
if(String(attType) == "Hosted") {
   Logger.log("This is also a match");
}

החזרות

AttachmentType – סוג הקובץ המצורף

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• https://sites.google.com/feeds

---

getContentType()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

החזר את סוג ה-MIME של הקובץ המצורף. השימוש בקבצים מצורפים לאינטרנט נכשל.

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();
var contentType = attachments[0].getContentType();

החזרות

String — סוג ה-MIME של הקובץ המצורף

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• https://sites.google.com/feeds

---

getDatePublished()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

החזרת התאריך שבו הקובץ המצורף פורסם לראשונה.

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();
var date = attachments[0].getDatePublished();

החזרות

Date – תאריך הפרסום המקורי

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• https://sites.google.com/feeds

---

getDescription()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

החזר את התיאור של הקובץ המצורף.

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();
var description = attachments[0].getDescription();

החזרות

String – התיאור של הקובץ המצורף

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• https://sites.google.com/feeds

---

getLastUpdated()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

החזרת התאריך שבו הקובץ המצורף עודכן לאחרונה.

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();
var date = attachments[0].getLastUpdated();

החזרות

Date – תאריך העדכון האחרון

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• https://sites.google.com/feeds

---

getParent()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הורדת דף ההורה של הקובץ המצורף.

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();

// This is equal to pages[0]
var parent = attachments[0].getParent();

החזרות

Page - דף ההורה

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• https://sites.google.com/feeds

---

getTitle()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

החזר את הכותרת של הקובץ המצורף.

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();
var title = attachments[0].getTitle();

החזרות

String – שם הקובץ המצורף

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• https://sites.google.com/feeds

---

getUrl()

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

החזרת כתובת ה-URL להורדה של הקובץ המצורף.

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();
var url = attachments[0].getUrl();

החזרות

String – כתובת ה-URL להורדה

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• https://sites.google.com/feeds

---

setContentType(contentType)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הגדרת סוג ה-MIME של הקובץ המצורף. השימוש בקבצים מצורפים לאינטרנט נכשל.

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();
attachments[0].setContentType("text/plain");

פרמטרים

שם	תיאור	התיאור
contentType	String	סוג ה-MIME החדש

החזרות

Attachment – קובץ מצורף זה לשרשור

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• https://sites.google.com/feeds

---

setDescription(description)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

יש להגדיר את התיאור של הקובץ המצורף.

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();

// This is an example of chaining in action
attachments[0].setTitle("New Title")
              .setDescription("New Description");

פרמטרים

שם	תיאור	התיאור
description	String	התיאור החדש

החזרות

Attachment – קובץ מצורף זה לשרשור

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• https://sites.google.com/feeds

---

setFrom(blob)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

עליך להגדיר את הנתונים עצמם של הקובץ המצורף. השימוש בקבצים מצורפים לאינטרנט נכשל.

var pages = SitesApp.getSite('demositeappsscript').getChildren();
var attachments = pages[0].getAttachments();

// This snippet demonstrates how to create a new text blob and attach it
// to the page
var blob = Utilities.newBlob("This data is now the attachment content");

// We must set a filename since we created the blob from String data
// instead of something like a URL source
blob.setName("attachment.txt");
attachments[0].setTitle("New Title")
              .setDescription("New Description")
              .setContentType("text/plain")
              .setFrom(blob);

פרמטרים

שם	תיאור	התיאור
blob	BlobSource	הנתונים החדשים

החזרות

Attachment – קובץ מצורף זה לשרשור

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• https://sites.google.com/feeds

---

setParent(parent)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

הגדרת דף ההורה של הקובץ המצורף.

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();
// Sets the parent page to be the next sibling
attachments[0].setParent(pages[1]);

פרמטרים

שם	תיאור	התיאור
parent	Page	ההורה החדש

החזרות

Attachment – קובץ מצורף זה לשרשור

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• https://sites.google.com/feeds

---

setTitle(title)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

כאן אפשר להגדיר כותרת לקובץ המצורף.

var pages = SitesApp.getSite('example.com', 'mysite').getChildren();
var attachments = pages[0].getAttachments();

// This is an example of chaining in action
attachments[0].setTitle("New Title")
              .setDescription("New Description");

פרמטרים

שם	תיאור	התיאור
title	String	השם החדש

החזרות

Attachment – קובץ מצורף זה לשרשור

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• https://sites.google.com/feeds

---

setUrl(url)

הוצא משימוש. הפונקציה הזו הוצאה משימוש ואין להשתמש בה בסקריפטים חדשים.

מגדיר את כתובת ה-URL להורדה של הקובץ המצורף. תקף רק לקבצים מצורפים באינטרנט.

var pages = SitesApp.getSite('demositeappsscript').getChildren();
var attachments = pages[0].getAttachments();

attachments[0].setTitle("New Web Attachment")
              .setDescription("New Description")
              .setUrl("http://example.com/files/your_file.txt");

פרמטרים

שם	תיאור	התיאור
url	String

החזרות

Attachment – קובץ מצורף זה לשרשור

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

• https://sites.google.com/feeds