Class GmailAttachment

Lampiran Gmail

Lampiran dari Gmail. Ini adalah Blob biasa, tetapi 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 di 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.

Return

Blob — Salinan baru.


getAs(contentType)

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

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

Parameter

NameJenisDeskripsi
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, salah satu dari 'image/bmp', 'image/gif', 'image/jpeg', atau 'image/png' juga valid.

Return

Blob - Data sebagai blob.


getBytes()

Mendapatkan data yang disimpan di blob ini.

Return

Byte[] — Byte tersimpan.


getContentType()

Mendapatkan jenis konten byte di blob ini.

Return

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


getDataAsString()

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

Return

String — Data sebagai string.


getDataAsString(charset)

Mendapatkan data blob ini sebagai string dengan encoding yang ditentukan.

Parameter

NameJenisDeskripsi
charsetStringCharset yang akan digunakan untuk mengenkode data di blob ini sebagai string.

Return

String — Data sebagai string.


getHash()

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

Return

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.

Return

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.

Return

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.).

Return

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


setBytes(data)

Menetapkan data yang disimpan di blob ini.

Parameter

NameJenisDeskripsi
dataByte[]Data baru.

Return

Blob — Blob ini, untuk perantaian.


setContentType(contentType)

Menetapkan jenis konten byte dalam blob ini.

Parameter

NameJenisDeskripsi
contentTypeStringcontentType baru.

Return

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.

Return

Blob — Blob ini, untuk perantaian.


setDataFromString(string)

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

Parameter

NameJenisDeskripsi
stringStringData string.

Return

Blob — Blob ini, untuk perantaian.


setDataFromString(string, charset)

Menetapkan data blob ini dari string dengan encoding yang ditentukan.

Parameter

NameJenisDeskripsi
stringStringData string.
charsetStringCharset yang digunakan untuk menafsirkan string sebagai byte.

Return

Blob — Blob ini, untuk perantaian.


setName(name)

Menetapkan nama blob ini.

Parameter

NameJenisDeskripsi
nameStringNama baru.

Return

Blob — Blob ini, untuk perantaian.

Metode yang tidak digunakan lagi