Class GmailAttachment

GmailAttachment

Lampiran dari Gmail. Ini adalah Blob biasa, kecuali memiliki metode getSize() tambahan yang lebih cepat daripada memanggil getBytes().length dan tidak mengurangi kuota baca Gmail.

// 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());
    }
  }
}

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
copyBlob()BlobMenampilkan salinan blob ini.
getAs(contentType)BlobMenampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan.
getBytes()Byte[]Mendapatkan data yang disimpan di blob ini.
getContentType()StringMendapatkan jenis konten byte dalam blob ini.
getDataAsString()StringMendapatkan data blob ini sebagai String dengan encoding UTF-8.
getDataAsString(charset)StringMendapatkan data blob ini sebagai string dengan encoding yang ditentukan.
getHash()StringMendapatkan hash konten SHA1 untuk lampiran ini.
getName()StringMendapatkan nama blob ini.
getSize()IntegerMendapatkan ukuran lampiran ini.
isGoogleType()BooleanMenampilkan apakah blob ini adalah file Google Workspace (Spreadsheet, Dokumen, dll.).
setBytes(data)BlobMenetapkan data yang disimpan di blob ini.
setContentType(contentType)BlobMenetapkan jenis konten byte dalam blob ini.
setContentTypeFromExtension()BlobMenetapkan jenis konten byte dalam blob ini berdasarkan ekstensi file.
setDataFromString(string)BlobMenetapkan data blob ini dari string dengan encoding UTF-8.
setDataFromString(string, charset)BlobMenetapkan data blob ini dari string dengan encoding yang ditentukan.
setName(name)BlobMenetapkan nama blob ini.

Dokumentasi mendetail

copyBlob()

Menampilkan salinan blob ini.

Pulang pergi

Blob — Salinan baru.


getAs(contentType)

Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan. Ini menambahkan ekstensi yang sesuai ke nama file—misalnya, "myfile.pdf". Namun, mengasumsikan bahwa bagian dari nama {i>file<i} yang mengikuti titik terakhir (jika ada) adalah bagian yang harus diganti. Akibatnya, "ShoppingList.12.25.2014" menjadi "ShoppingList.12.25.pdf".

Untuk melihat kuota harian untuk konversi, lihat Kuota untuk Google Layanan. Domain Google Workspace yang baru dibuat mungkin tunduk kepada aturan yang lebih ketat kuota tambahan.

Parameter

NamaJenisDeskripsi
contentTypeStringJenis MIME yang menjadi tujuan konversi. Untuk sebagian besar blob, 'application/pdf' adalah satu-satunya opsi yang valid. Untuk gambar dalam format BMP, GIF, JPEG, atau PNG, dari 'image/bmp', 'image/gif', 'image/jpeg', atau 'image/png' juga valid. Untuk dokumen Google Dokumen, 'text/markdown' juga valid.

Pulang pergi

Blob — Data sebagai blob.


getBytes()

Mendapatkan data yang disimpan di blob ini.

Pulang pergi

Byte[] — Byte yang disimpan.


getContentType()

Mendapatkan jenis konten byte dalam blob ini.

Pulang pergi

String — Jenis konten data ini, jika diketahui, atau null.


getDataAsString()

Mendapatkan data blob ini sebagai String dengan encoding UTF-8.

Pulang pergi

String — Data sebagai string.


getDataAsString(charset)

Mendapatkan data blob ini sebagai string dengan encoding yang ditentukan.

Parameter

NamaJenisDeskripsi
charsetStringKumpulan karakter yang akan digunakan dalam mengenkode data dalam blob ini sebagai string.

Pulang pergi

String — Data sebagai string.


getHash()

Mendapatkan hash konten SHA1 untuk lampiran ini. Metode ini tidak diperhitungkan terhadap Gmail kuota baca.

Pulang pergi

String — Hash konten SHA1, sebagai string.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut atau cakupan yang sesuai dari REST API terkait:

  • https://mail.google.com/

getName()

Mendapatkan nama blob ini.

Pulang pergi

String — Nama data ini, jika diketahui, atau null.


getSize()

Mendapatkan ukuran lampiran ini. Metode ini lebih cepat daripada memanggil getBytes().length dan tidak mengurangi kuota baca Gmail.

Pulang pergi

Integer — Ukuran lampiran, dalam byte.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut atau cakupan yang sesuai dari REST API terkait:

  • https://mail.google.com/

isGoogleType()

Menampilkan apakah blob ini adalah file Google Workspace (Spreadsheet, Dokumen, dll.).

Pulang pergi

Booleantrue jika blob ini adalah file Google Workspace; false jika tidak.


setBytes(data)

Menetapkan data yang disimpan di blob ini.

Parameter

NamaJenisDeskripsi
dataByte[]Data baru.

Pulang pergi

Blob — Blob ini, untuk perantaian.


setContentType(contentType)

Menetapkan jenis konten byte dalam blob ini.

Parameter

NamaJenisDeskripsi
contentTypeStringContentType baru.

Pulang pergi

Blob — Blob ini, untuk perantaian.


setContentTypeFromExtension()

Menetapkan jenis konten byte dalam blob ini berdasarkan ekstensi file. ContentType adalah null jika tidak dapat ditebak dari ekstensinya.

Pulang pergi

Blob — Blob ini, untuk perantaian.


setDataFromString(string)

Menetapkan data blob ini dari string dengan encoding UTF-8.

Parameter

NamaJenisDeskripsi
stringStringData {i>string<i}.

Pulang pergi

Blob — Blob ini, untuk perantaian.


setDataFromString(string, charset)

Menetapkan data blob ini dari string dengan encoding yang ditentukan.

Parameter

NamaJenisDeskripsi
stringStringData {i>string<i}.
charsetStringKumpulan karakter yang akan digunakan dalam menafsirkan string sebagai byte.

Pulang pergi

Blob — Blob ini, untuk perantaian.


setName(name)

Menetapkan nama blob ini.

Parameter

NamaJenisDeskripsi
nameStringNama baru.

Pulang pergi

Blob — Blob ini, untuk perantaian.

Metode yang tidak digunakan lagi