Class Attachment

Allegato

Obsoleta. Questo corso è deprecato e non deve essere utilizzato in nuovi script.

Un allegato di Sites, ad esempio un file allegato a una pagina.

Tieni presente che un allegato è un BLOB e può essere utilizzato ovunque sia previsto un input 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]);

Metodi

Metodo	Tipo restituito	Breve descrizione
getAs(contentType)	Blob	Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuto specificato.
getBlob()	Blob	Restituisce i dati all'interno dell'oggetto sotto forma di blob.

Metodi deprecati

Metodo	Tipo restituito	Breve descrizione
deleteAttachment()	void	Elimina questo allegato.
getAttachmentType()	AttachmentType	Restituisce il tipo di questo allegato (HOSTED o WEB).
getContentType()	String	Restituisce il tipo MIME di questo allegato.
getDatePublished()	Date	Restituisce la data della prima pubblicazione dell'allegato.
getDescription()	String	Restituisce la descrizione di questo allegato.
getLastUpdated()	Date	Restituisce la data dell'ultimo aggiornamento di questo allegato.
getParent()	Page	Scarica la pagina principale di questo allegato.
getTitle()	String	Restituisce il titolo di questo allegato.
getUrl()	String	Restituisci l'URL di download dell'allegato.
setContentType(contentType)	Attachment	Imposta il tipo MIME di questo allegato.
setDescription(description)	Attachment	Imposta la descrizione di questo allegato.
setFrom(blob)	Attachment	Imposta i dati effettivi di questo allegato.
setParent(parent)	Attachment	Imposta la pagina principale di questo allegato.
setTitle(title)	Attachment	Imposta il titolo di questo allegato.
setUrl(url)	Attachment	Imposta l'URL di download per questo allegato.

Documentazione dettagliata

getAs(contentType)

Restituisce i dati all'interno di questo oggetto come blob convertito nel tipo di contenuto specificato. Questo aggiunge l'estensione appropriata al nome del file, ad esempio "miofile.pdf". Tuttavia, presuppone che la parte del nome file che segue l'ultimo punto (se presente) sia una un'estensione che deve essere sostituita. Di conseguenza, "ShoppingList.25.12.2014" diventa "ShoppingList.12.25.pdf".

Per visualizzare le quote giornaliere per le conversioni, consulta Quote per Google Servizi. I domini Google Workspace appena creati potrebbero essere temporaneamente soggetti a restrizioni quote.

Parametri

Nome	Tipo	Descrizione
contentType	String	Il tipo MIME in cui eseguire la conversione. Per la maggior parte dei blob, 'application/pdf' è è l'unica opzione valida. Per le immagini in formato BMP, GIF, JPEG o PNG, vengono visualizzati anche i valori 'image/bmp', 'image/gif', 'image/jpeg' o 'image/png' valida. Per un documento di Documenti Google è valido anche 'text/markdown'.

Invio

Blob: i dati come blob.

---

getBlob()

Restituisce i dati all'interno dell'oggetto sotto forma di blob.

Invio

Blob: i dati come blob.

Metodi deprecati

deleteAttachment()

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Elimina questo allegato.

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

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getAttachmentType()

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Restituisce il tipo di questo allegato (HOSTED o 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");
}

Invio

AttachmentType: il tipo di allegato

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getContentType()

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Restituisce il tipo MIME di questo allegato. Non valido per gli allegati web.

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

Invio

String: tipo MIME dell'allegato

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getDatePublished()

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Restituisce la data della prima pubblicazione dell'allegato.

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

Invio

Date: la data di pubblicazione originale

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getDescription()

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Restituisce la descrizione di questo allegato.

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

Invio

String: la descrizione dell'allegato

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getLastUpdated()

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Restituisce la data dell'ultimo aggiornamento di questo allegato.

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

Invio

Date: la data dell'ultimo aggiornamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getParent()

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Scarica la pagina principale di questo allegato.

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

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

Invio

Page: la pagina principale

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getTitle()

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Restituisce il titolo di questo allegato.

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

Invio

String: il titolo dell'allegato

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

getUrl()

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Restituisci l'URL di download dell'allegato.

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

Invio

String: l'URL di download.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

setContentType(contentType)

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Imposta il tipo MIME di questo allegato. Non valido per gli allegati web.

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

Parametri

Nome	Tipo	Descrizione
contentType	String	il nuovo tipo MIME

Invio

Attachment - questo allegato per il concatenamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

setDescription(description)

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Imposta la descrizione di questo allegato.

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");

Parametri

Nome	Tipo	Descrizione
description	String	la nuova descrizione

Invio

Attachment - questo allegato per il concatenamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

setFrom(blob)

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Imposta i dati effettivi di questo allegato. Non valido per gli allegati web.

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

Parametri

Nome	Tipo	Descrizione
blob	BlobSource	i nuovi dati

Invio

Attachment - questo allegato per il concatenamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

setParent(parent)

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Imposta la pagina principale di questo allegato.

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]);

Parametri

Nome	Tipo	Descrizione
parent	Page	il nuovo genitore

Invio

Attachment - questo allegato per il concatenamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

setTitle(title)

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Imposta il titolo di questo allegato.

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");

Parametri

Nome	Tipo	Descrizione
title	String	il nuovo titolo

Invio

Attachment - questo allegato per il concatenamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

setUrl(url)

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Imposta l'URL di download per questo allegato. Valido solo per gli allegati web.

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");

Parametri

Nome	Tipo	Descrizione
url	String

Invio

Attachment - questo allegato per il concatenamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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