Class Attachment

Allegato

Obsoleta. Questa classe è deprecata e non deve essere utilizzata nei 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 l'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 sotto forma di blob convertito nel tipo di contenuto specificato.
getBlob()	Blob	Restituisce i dati all'interno di questo 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	Indica la data della prima pubblicazione dell'allegato.
getDescription()	String	Restituisci la descrizione dell'allegato.
getLastUpdated()	Date	Indica la data dell'ultimo aggiornamento dell'allegato.
getParent()	Page	Ottieni la pagina principale di questo allegato.
getTitle()	String	Restituisce il titolo dell'allegato.
getUrl()	String	Restituisce l'URL di download per questo allegato.
setContentType(contentType)	Attachment	Imposta il tipo MIME di questo collegamento.
setDescription(description)	Attachment	Imposta la descrizione di questo allegato.
setFrom(blob)	Attachment	Imposta i dati effettivi dell'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 sotto forma di blob convertito nel tipo di contenuto specificato. Questo metodo aggiunge l'estensione appropriata al nome del file, ad esempio "myfile.pdf". Tuttavia, si presuppone che la parte del nome del file che segue l'ultimo punto (se presente) sia un'estensione esistente che deve essere sostituita. Di conseguenza, "ShoppingList.12.25.2014" diventa "ShoppingList.12.25.pdf".

Per visualizzare le quote giornaliere per le conversioni, consulta Quote per i servizi Google. I domini Google Workspace appena creati potrebbero essere temporaneamente soggetti a quote più severe.

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, è valido anche qualsiasi formato 'image/bmp', 'image/gif', 'image/jpeg' o 'image/png'.

Ritorni

Blob: i dati sotto forma di blob.

---

getBlob()

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

Ritorni

Blob: i dati sotto forma di 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");
}

Ritorni

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 riuscito per gli allegati web.

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

Ritorni

String: il 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.

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

Ritorni

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.

Restituisci la descrizione dell'allegato.

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

Ritorni

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.

Indica la data dell'ultimo aggiornamento dell'allegato.

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

Ritorni

Date: 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.

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

Ritorni

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

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

Ritorni

String: 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.

Restituisce l'URL di download per questo allegato.

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

Ritorni

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 collegamento. Non riuscito 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

Ritorni

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

Ritorni

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 dell'allegato. Non riuscito 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

Ritorni

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

Ritorni

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

Ritorni

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

Ritorni

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