Class Attachment

קובץ מצורף

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

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

הערה: קובץ מצורף הוא Blob ואפשר להשתמש בו בכל מקום שבו צפוי קלט Blob.

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 שהומר לסוג התוכן שצוין. הזה method מוסיפה את הסיומת המתאימה לשם הקובץ, לדוגמה, "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.

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

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