Class Attachment

Anexo

Obsoleto. Essa classe foi descontinuada e não deve ser usada em novos scripts.

Um anexo do Google Sites, como um arquivo anexado a uma página.

Observe que um anexo é um Blob e pode ser usado em qualquer lugar em que uma entrada Blob seja esperada.

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étodo	Tipo de retorno	Breve descrição
getAs(contentType)	Blob	Retorna os dados dentro desse objeto como um blob convertido no tipo de conteúdo especificado.
getBlob()	Blob	Retorne os dados dentro desse objeto como um blob.

Métodos obsoletos

Método	Tipo de retorno	Breve descrição
deleteAttachment()	void	Exclui este anexo.
getAttachmentType()	AttachmentType	Retorna o tipo deste anexo (HOSTED ou WEB).
getContentType()	String	Retorna o tipo MIME deste anexo.
getDatePublished()	Date	Retorna a data em que este anexo foi publicado pela primeira vez.
getDescription()	String	Retorna a descrição deste anexo.
getLastUpdated()	Date	Retorne a data em que este anexo foi atualizado pela última vez.
getParent()	Page	Extrai a página pai deste anexo.
getTitle()	String	Retorna o título deste anexo.
getUrl()	String	Retorne o URL de download desse anexo.
setContentType(contentType)	Attachment	Define o tipo MIME deste anexo.
setDescription(description)	Attachment	Defina a descrição deste anexo.
setFrom(blob)	Attachment	Defina os dados reais deste anexo.
setParent(parent)	Attachment	Defina a página principal deste anexo.
setTitle(title)	Attachment	Defina o título deste anexo.
setUrl(url)	Attachment	Define o URL de download deste anexo.

Documentação detalhada

getAs(contentType)

Retorna os dados dentro desse objeto como um blob convertido no tipo de conteúdo especificado. Isso adiciona a extensão adequada ao nome do arquivo, por exemplo, "myfile.pdf". No entanto, pressupõe que a parte do nome do arquivo que segue o ponto final (se houver) é um que deve ser substituída. Consequentemente, "ShoppingList.12.25.2014" se torna "ListaShopping.12.25.pdf".

Para acessar as cotas diárias para conversões, consulte Cotas do Google Serviços. Os domínios do Google Workspace recém-criados podem estar temporariamente sujeitos a medidas cotas.

Parâmetros

Nome	Tipo	Descrição
contentType	String	O tipo MIME em que a conversão será feita. Para a maioria dos blobs, 'application/pdf' é a única opção válida. Para imagens no formato BMP, GIF, JPEG ou PNG, qualquer um dos valores 'image/bmp', 'image/gif', 'image/jpeg' ou 'image/png' também precisa ser válidos. Para um documento do Documentos Google, 'text/markdown' também é válido.

Retornar

Blob: os dados como um blob.

---

getBlob()

Retorne os dados dentro desse objeto como um blob.

Retornar

Blob: os dados como um blob.

Métodos obsoletos

deleteAttachment()

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Exclui este anexo.

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

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

---

getAttachmentType()

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Retorna o tipo deste anexo (HOSTED ou 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");
}

Retornar

AttachmentType: o tipo de anexo.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

---

getContentType()

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Retorna o tipo MIME deste anexo. Falha nos anexos da Web.

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

Retornar

String: o tipo MIME do anexo.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

---

getDatePublished()

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Retorna a data em que este anexo foi publicado pela primeira vez.

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

Retornar

Date: a data da publicação original

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

---

getDescription()

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Retorna a descrição deste anexo.

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

Retornar

String: a descrição do anexo.

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

---

getLastUpdated()

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Retorne a data em que este anexo foi atualizado pela última vez.

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

Retornar

Date: a data da última atualização

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

---

getParent()

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Extrai a página pai deste anexo.

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

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

Retornar

Page: a página principal

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

---

getTitle()

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Retorna o título deste anexo.

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

Retornar

String: o título do anexo

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

---

getUrl()

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Retorne o URL de download desse anexo.

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

Retornar

String: o URL de download

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

---

setContentType(contentType)

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o tipo MIME deste anexo. Falha nos anexos da Web.

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

Parâmetros

Nome	Tipo	Descrição
contentType	String	o novo tipo MIME

Retornar

Attachment: este anexo para encadeamento

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

---

setDescription(description)

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Defina a descrição deste anexo.

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

Nome	Tipo	Descrição
description	String	a nova descrição

Retornar

Attachment: este anexo para encadeamento

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

---

setFrom(blob)

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Defina os dados reais deste anexo. Falha nos anexos da 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

Nome	Tipo	Descrição
blob	BlobSource	os novos dados

Retornar

Attachment: este anexo para encadeamento

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

---

setParent(parent)

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Defina a página principal deste anexo.

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

Nome	Tipo	Descrição
parent	Page	o novo pai

Retornar

Attachment: este anexo para encadeamento

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

---

setTitle(title)

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Defina o título deste anexo.

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

Nome	Tipo	Descrição
title	String	o novo título

Retornar

Attachment: este anexo para encadeamento

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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

---

setUrl(url)

Obsoleto. Essa função foi descontinuada e não deve ser usada em novos scripts.

Define o URL de download para este anexo. Válido apenas para anexos da 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

Nome	Tipo	Descrição
url	String

Retornar

Attachment: este anexo para encadeamento

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

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