Class GmailAttachment

Gmail'den gelen bir ek Bu, getBytes().length işlevini çağırmaktan daha hızlı olan ve Gmail okuma kotasına dahil edilmeyen ek bir getSize() yöntemi içermesi 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öntem	Dönüş türü	Kısa açıklama
`copyBlob()`	`Blob`	Bu blob'un bir kopyasını döndürür.
`getAs(contentType)`	`Blob`	Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürür.
`getBytes()`	`Byte[]`	Bu blob'da depolanan verileri alır.
`getContentType()`	`String\|null`	Bu blob'daki baytların içerik türünü alır.
`getDataAsString()`	`String`	Bu blob'un verilerini UTF-8 kodlamasıyla dize olarak alır.
`getDataAsString(charset)`	`String`	Bu blob'un verilerini belirtilen kodlamayla dize olarak alır.
`getHash()`	`String`	Bu ek için SHA1 içerik karma değerini alır.
`getName()`	`String\|null`	Bu blob'un adını alır.
`getSize()`	`Integer`	Bu ekin boyutunu alır.
`isGoogleType()`	`Boolean`	Bu blob'un Google Workspace dosyası (E-Tablolar, Dokümanlar vb.) olup olmadığını döndürür.
`setBytes(data)`	`Blob`	Bu blob'da depolanan verileri ayarlar.
`setContentType(contentType)`	`Blob`	Bu blob'daki baytların içerik türünü ayarlar.
`setContentTypeFromExtension()`	`Blob`	Dosya uzantısına göre bu blob'daki baytların içerik türünü ayarlar.
`setDataFromString(string)`	`Blob`	Bu blob'un verilerini UTF-8 kodlamalı bir dizeden ayarlar.
`setDataFromString(string, charset)`	`Blob`	Belirtilen kodlamaya sahip bir dizeden bu blob'un verilerini ayarlar.
`setName(name)`	`Blob`	Bu blob'un adını ayarlar.

Kullanımdan kaldırılan yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`getAllBlobs()`	`Blob[]`	Bu (muhtemelen bileşik) blob'da bulunan tüm blob'ları alır.

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ür. Bu yöntem, dosya adına uygun uzantıyı ekler (ör. "dosyam.pdf"). Ancak, dosya adının son noktadan sonraki kısmının (varsa) değiştirilmesi gereken mevcut bir uzantı olduğunu varsayar. Dolayısıyla, "ShoppingList.12.25.2014" ifadesi "ShoppingList.12.25.pdf" olur.

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

Parametreler

Ad	Tür	Açıklama
`contentType`	`String`	Dönüştürülecek MIME türü. Çoğu blob için tek geçerli seçenek `'application/pdf'`'dır. BMP, GIF, JPEG veya PNG biçimindeki resimler için `'image/bmp'`, `'image/gif'`, `'image/jpeg'` veya `'image/png'` de geçerlidir. Google Dokümanlar dokümanlarında `'text/markdown'` da geçerlidir.

Return

Blob — Veriler blob olarak.

`getBytes()`

Bu blob'da depolanan verileri alır.

Return

Byte[]: Depolanan baytlar.

`getContentType()`

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

Return

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

`getDataAsString()`

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

Return

String: Dize olarak veriler.

`getDataAsString(charset)`

Bu blob'un verilerini belirtilen kodlamayla dize olarak alır.

Parametreler

Ad	Tür	Açıklama
`charset`	`String`	Bu blob'daki verileri dize olarak kodlarken kullanılacak karakter kümesi.

Return

String: Dize olarak veriler.

`getHash()`

Bu ek için SHA1 içerik karma değerini alır. Bu yöntem, Gmail okuma kotası kapsamında değerlendirilmez.

Return

String: SHA1 içerik karma değeri (dize olarak).

Yetkilendirme

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

https://mail.google.com/

`getName()`

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

Return

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

`getSize()`

Bu ekin boyutunu alır. Bu yöntem, getBytes().length numaralı telefonu aramaktan daha hızlıdır ve Gmail okuma kotası kapsamında değerlendirilmez.

Return

Integer: Ekin bayt cinsinden boyutu.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlası ya da ilgili REST API'den 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

Bu blob bir Google Workspace dosyasıysa Boolean, değilse true.false

`setBytes(data)`

Bu blob'da depolanan verileri ayarlar.