Class Attachment

Archivo adjunto

Un archivo adjunto de Sites, como un archivo adjunto a una página.

Ten en cuenta que un adjunto es un BLOB y se puede usar en cualquier lugar en el que se espere una entrada de 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]);

Métodos

MétodoTipo de datos que se muestraDescripción breve
deleteAttachment()voidBorra este archivo adjunto.
getAs(contentType)BlobMuestra los datos dentro de este objeto como un BLOB convertido al tipo de contenido especificado.
getAttachmentType()AttachmentTypeMuestra el tipo de este archivo adjunto (HOSTED o WEB).
getBlob()BlobMuestra los datos dentro de este objeto como un BLOB.
getContentType()StringMuestra el tipo de MIME de este adjunto.
getDatePublished()DateMuestra la fecha en que se publicó este archivo adjunto por primera vez.
getDescription()StringMuestra la descripción de este archivo adjunto.
getLastUpdated()DateMuestra la fecha de la última actualización del archivo adjunto.
getParent()PageObtén la página superior de este archivo adjunto.
getTitle()StringMuestra el título de este archivo adjunto.
getUrl()StringMuestra la URL de descarga para este archivo adjunto.
setContentType(contentType)AttachmentEstablece el tipo de MIME de este adjunto.
setDescription(description)AttachmentEstablece la descripción de este archivo adjunto.
setFrom(blob)AttachmentEstablece los datos reales de este adjunto.
setParent(parent)AttachmentEstablece la página principal de este archivo adjunto.
setTitle(title)AttachmentEstablece el título de este archivo adjunto.
setUrl(url)AttachmentEstablece la URL de descarga para este archivo adjunto.

Documentación detallada

deleteAttachment()

Borra este archivo adjunto.

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

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

getAs(contentType)

Muestra los datos dentro de este objeto como un BLOB convertido al tipo de contenido especificado. Este método agrega la extensión adecuada al nombre del archivo, por ejemplo, &myt.myfile.pdf". Sin embargo, se supone que la parte del nombre de archivo que sigue al último período (si existe) es una extensión existente que se debe reemplazar. En consecuencia, "ShoppingList.15.15.2014" pasa a ser "ShoppingList.12.25.pdf".

Si quieres ver las cuotas diarias para conversiones, consulta Cuotas para servicios de Google. Es posible que los dominios de Google Workspace recién creados estén sujetos a cuotas más estrictas.

Parámetros

NombreTipoDescripción
contentTypeStringEl tipo de MIME al que se realizará la conversión. Para la mayoría de los BLOB, 'application/pdf' es la única opción válida. Para imágenes en formato BMP, GIF, JPEG o PNG, también son válidos 'image/bmp', 'image/gif', 'image/jpeg' o 'image/png'.

Volver

Blob: los datos como un BLOB


getAttachmentType()

Muestra el tipo de este archivo adjunto (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");
}

Volver

AttachmentType: Es el tipo de archivo adjunto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

getBlob()

Muestra los datos dentro de este objeto como un BLOB.

Volver

Blob: los datos como un BLOB


getContentType()

Muestra el tipo de MIME de este adjunto. Errores en los archivos adjuntos web.

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

Volver

String: Es el tipo de MIME adjunto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

getDatePublished()

Muestra la fecha en que se publicó este archivo adjunto por primera vez.

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

Volver

Date: Es la fecha de publicación original.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

getDescription()

Muestra la descripción de este archivo adjunto.

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

Volver

String: la descripción del archivo adjunto

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

getLastUpdated()

Muestra la fecha de la última actualización del archivo adjunto.

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

Volver

Date: La fecha de la última actualización

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

getParent()

Obtén la página superior de este archivo adjunto.

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

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

Volver

Page: La página principal

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

getTitle()

Muestra el título de este archivo adjunto.

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

Volver

String: Es el título del archivo adjunto.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

getUrl()

Muestra la URL de descarga para este archivo adjunto.

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

Volver

String: Es la URL de descarga.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

setContentType(contentType)

Establece el tipo de MIME de este adjunto. Errores en los archivos adjuntos web.

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

Parámetros

NombreTipoDescripción
contentTypeStringel nuevo tipo de MIME

Volver

Attachment: este adjunto para encadenar

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

setDescription(description)

Establece la descripción de este archivo adjunto.

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

Parámetros

NombreTipoDescripción
descriptionStringla nueva descripción

Volver

Attachment: este adjunto para encadenar

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

setFrom(blob)

Establece los datos reales de este adjunto. Errores en los archivos adjuntos 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);

Parámetros

NombreTipoDescripción
blobBlobSourcelos nuevos datos

Volver

Attachment: este adjunto para encadenar

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

setParent(parent)

Establece la página principal de este archivo adjunto.

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

Parámetros

NombreTipoDescripción
parentPageel nuevo padre o madre

Volver

Attachment: este adjunto para encadenar

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

setTitle(title)

Establece el título de este archivo adjunto.

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

Parámetros

NombreTipoDescripción
titleStringel nuevo título

Volver

Attachment: este adjunto para encadenar

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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

setUrl(url)

Establece la URL de descarga para este archivo adjunto. Solo es válido para los archivos adjuntos 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");

Parámetros

NombreTipoDescripción
urlString

Volver

Attachment: este adjunto para encadenar

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:

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