Class GmailAttachment

GmailAttachment

Gmail'den bir ek. Bu, çağrıdan daha hızlı olan ek bir getSize() yöntemine sahip olması dışında normal bir Blob öğesidir getBytes().length ve Gmail okuma kotasına dahil edilmez.

// Logs information about any attachments in the first 100 inbox threads.
var threads = GmailApp.getInboxThreads(0, 100);
var msgs = GmailApp.getMessagesForThreads(threads);
for (var i = 0 ; i < msgs.length; i++) {
  for (var j = 0; j < msgs[i].length; j++) {
    var attachments = msgs[i][j].getAttachments();
    for (var k = 0; k < attachments.length; k++) {
      Logger.log('Message "%s" contains the attachment "%s" (%s bytes)',
                 msgs[i][j].getSubject(), attachments[k].getName(), attachments[k].getSize());
    }
  }
}

Yöntemler

YöntemDönüş türüKısa açıklama
copyBlob()BlobBu blob'un bir kopyasını döndürür.
getAs(contentType)BlobBu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürün.
getBytes()Byte[]Bu blob'da depolanan verileri alır.
getContentType()StringBu blobdaki baytların içerik türünü alır.
getDataAsString()StringBu blob'un verilerini UTF-8 kodlamalı bir Dize olarak alır.
getDataAsString(charset)StringBu blobun verilerini, belirtilen kodlamaya sahip bir dize olarak alır.
getHash()StringBu ek için SHA1 içerik karmasını alır.
getName()StringBu blobun adını alır.
getSize()IntegerBu ekin boyutunu alır.
isGoogleType()BooleanBu blob'un Google Workspace dosyası (E-Tablolar, Dokümanlar vb.) olup olmadığını döndürür.
setBytes(data)BlobBu blob'da depolanan verileri ayarlar.
setContentType(contentType)BlobBu blobdaki baytların içerik türünü ayarlar.
setContentTypeFromExtension()BlobDosya uzantısına göre bu blobdaki baytların içerik türünü ayarlar.
setDataFromString(string)BlobBu blob'un verilerini UTF-8 kodlamasına sahip bir dizeden ayarlar.
setDataFromString(string, charset)BlobBu blob'un verilerini, belirtilen kodlamaya sahip bir dizeden ayarlar.
setName(name)BlobBu blob'un adını ayarlar.

Ayrıntılı belgeler

copyBlob()

Bu blob'un bir kopyasını döndürür.

Return

Blob — Yeni kopya.


getAs(contentType)

Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürün. Bu yöntemi, dosya adına uygun uzantıyı ekler. Örneğin, "dosyam.pdf". Ancak, dosya adında son noktadan sonra gelen bölümün (varsa) mevcut bir alan olduğunu varsayar değiştirilmesi gereken uzantıdır. Sonuç olarak, "AlışverişListesi.12.25.2014" şu olur: "ShoppingList.12.25.pdf".

Günlük dönüşüm kotalarını görüntülemek için bkz. Google için Kotalar Hizmetler. Yeni oluşturulan Google Workspace alanları geçici olarak daha sıkılığa tabi olabilir kotalar.

Parametreler

AdTürAçıklama
contentTypeStringDönüşümün gerçekleştirileceği MIME türü. Çoğu blob için 'application/pdf', tek geçerli seçenektir. BMP, GIF, JPEG veya PNG biçimindeki resimler için 'image/bmp', 'image/gif', 'image/jpeg' veya 'image/png''ten herhangi biri de geçerlidir. Bir Google Dokümanlar dokümanı için 'text/markdown' ayrıca geçerlidir.

Return

Blob — Veriler bir blob olarak.


getBytes()

Bu blob'da depolanan verileri alır.

Return

Byte[] — Depolanan bayt miktarı.


getContentType()

Bu blobdaki baytların içerik türünü alır.

Return

String — Bu verinin içerik türü (biliniyorsa veya null).


getDataAsString()

Bu blob'un verilerini UTF-8 kodlamalı bir Dize olarak alır.

Return

String — Dize biçiminde olan veriler.


getDataAsString(charset)

Bu blobun verilerini, belirtilen kodlamaya sahip bir dize olarak alır.

Parametreler

AdTürAçıklama
charsetStringBu blobdaki verileri dize olarak kodlamada kullanılacak karakter kümesi.

Return

String — Dize biçiminde olan veriler.


getHash()

Bu ek için SHA1 içerik karmasını alır. Bu yöntem Gmail'de geçerli değildir okuma kotası.

Return

String: Dize olarak, SHA1 içerik karması.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla ya da ilgili REST API'sinden uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

getName()

Bu blobun adını alır.

Return

String — Bu verinin adı (biliniyorsa veya null).


getSize()

Bu ekin boyutunu alır. Bu yöntem getBytes().length çağrısından daha hızlıdır ve Gmail okuma kotasına dahil edilmez.

Return

Integer: Ekin bayt cinsinden boyutu.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla ya da ilgili REST API'sinden uygun kapsamlarla yetkilendirme gerektirir:

  • https://mail.google.com/

isGoogleType()

Bu blob'un Google Workspace dosyası (E-Tablolar, Dokümanlar vb.) olup olmadığını döndürür.

Return

Boolean: Bu blob bir Google Workspace dosyasıysa true; Değilse false.


setBytes(data)

Bu blob'da depolanan verileri ayarlar.

Parametreler

AdTürAçıklama
dataByte[]Yeni veriler.

Return

Blob — Zincirleme amaçlı bu blob.


setContentType(contentType)

Bu blobdaki baytların içerik türünü ayarlar.

Parametreler

AdTürAçıklama
contentTypeStringYeni contentType.

Return

Blob — Zincirleme amaçlı bu blob.


setContentTypeFromExtension()

Dosya uzantısına göre bu blobdaki baytların içerik türünü ayarlar. contentType, Uzantısından tahmin edilemiyorsa null.

Return

Blob — Zincirleme amaçlı bu blob.


setDataFromString(string)

Bu blob'un verilerini UTF-8 kodlamasına sahip bir dizeden ayarlar.

Parametreler

AdTürAçıklama
stringStringDize verileri.

Return

Blob — Zincirleme amaçlı bu blob.


setDataFromString(string, charset)

Bu blob'un verilerini, belirtilen kodlamaya sahip bir dizeden ayarlar.

Parametreler

AdTürAçıklama
stringStringDize verileri.
charsetStringDizeyi bayt olarak yorumlamada kullanılacak karakter kümesi.

Return

Blob — Zincirleme amaçlı bu blob.


setName(name)

Bu blob'un adını ayarlar.

Parametreler

AdTürAçıklama
nameStringYeni ad.

Return

Blob — Zincirleme amaçlı bu blob.

Desteği sonlandırılan yöntemler