Class GmailAttachment

GmailEk

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

// Logs information about any attachments in the first 100 inbox threads.
const threads = GmailApp.getInboxThreads(0, 100);
const msgs = GmailApp.getMessagesForThreads(threads);
for (let i = 0; i < msgs.length; i++) {
  for (let j = 0; j < msgs[i].length; j++) {
    const attachments = msgs[i][j].getAttachments();
    for (let 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ürme.
getBytes()Byte[]Bu blob'da depolanan verileri alır.
getContentType()StringBu blob'daki baytların içerik türünü alır.
getDataAsString()StringBu blob'un verilerini UTF-8 kodlamasıyla dize olarak alır.
getDataAsString(charset)StringBu blob'un verilerini, belirtilen kodlamayı içeren bir dize olarak alır.
getHash()StringBu ekin SHA1 içerik karma değerini alır.
getName()StringBu blob'un 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 blob'daki baytların içerik türünü ayarlar.
setContentTypeFromExtension()BlobBu blob'daki baytların içerik türünü dosya uzantısına göre belirler.
setDataFromString(string)BlobBu blob'un verilerini UTF-8 kodlamalı bir dizeden ayarlar.
setDataFromString(string, charset)BlobBu blob'un verilerini, belirtilen kodlamaya sahip bir dizeden ayarlar.
setName(name)BlobBu blob'un adını belirler.

Ayrıntılı dokümanlar

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ürme. Bu yöntem, dosya adına uygun uzantıyı ekler (ör. "dosyam.pdf"). Ancak, dosya adının son noktayı (varsa) izleyen kısmının, değiştirilmesi gereken mevcut bir uzantı olduğu varsayılır. Sonuç olarak, "AlışverişListesi.25.12.2014", "AlışverişListesi.25.12.pdf" olur.

Dönüşümler için günlük kotaları görüntülemek istiyorsanız Google Hizmetleri için kotalar başlıklı makaleyi inceleyin. Yeni oluşturulan Google Workspace alanları geçici olarak daha katı kotalara tabi olabilir.

Parametreler

AdTürAçıklama
contentTypeStringDönüştürülecek 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' değerlerinden herhangi biri de geçerlidir. Google Dokümanlar dokümanları için 'text/markdown' de geçerlidir.

Return

Blob: Veriler bir blob olarak.


getBytes()

Bu blob'da depolanan verileri alır.

Return

Byte[]: Depolanan bayt sayısı.


getContentType()

Bu blob'daki baytların içerik türünü alır.

Return

String: Biliniyorsa bu verilerin içerik türü veya null.


getDataAsString()

Bu blob'un verilerini UTF-8 kodlamasıyla dize olarak alır.

Return

String: Veriler dize olarak.


getDataAsString(charset)

Bu blob'un verilerini, belirtilen kodlamayı içeren bir dize olarak alır.

Parametreler

AdTürAçıklama
charsetStringBu blob'daki verileri dize olarak kodlarken kullanılacak karakter kümesi.

Return

String: Veriler dize olarak.


getHash()

Bu ekin SHA1 içerik karma değerini alır. Bu yöntem, Gmail okuma kotasına dahil edilmez.

Return

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

Yetkilendirme

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

  • https://mail.google.com/

getName()

Bu blob'un adını alır.

Return

String: Biliniyorsa bu verilerin adı 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 veya ilgili REST API'deki 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 değerini alır.


setBytes(data)

Bu blob'da depolanan verileri ayarlar.

Parametreler

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

Return

Blob: Zincirleme için bu blob.


setContentType(contentType)

Bu blob'daki baytların içerik türünü ayarlar.

Parametreler

AdTürAçıklama
contentTypeStringYeni contentType.

Return

Blob: Zincirleme için bu blob.


setContentTypeFromExtension()

Bu blob'daki baytların içerik türünü dosya uzantısına göre belirler. Uzantısından tahmin edilemiyorsa contentType değeri null olur.

Return

Blob: Zincirleme için bu blob.


setDataFromString(string)

Bu blob'un verilerini UTF-8 kodlamalı bir dizeden ayarlar.

Parametreler

AdTürAçıklama
stringStringDize verileri.

Return

Blob: Zincirleme için bu blob.


setDataFromString(string, charset)

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

Parametreler

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

Return

Blob: Zincirleme için bu blob.


setName(name)

Bu blob'un adını belirler.

Parametreler

AdTürAçıklama
nameStringYeni ad.

Return

Blob: Zincirleme için bu blob.

Kullanımdan kaldırılan yöntemler