Halaman ini diterjemahkan oleh Cloud Translation API.

Class GmailAttachment

Lampiran dari Gmail. Ini adalah Blob biasa, kecuali bahwa metode ini 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

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`copyBlob()`	`Blob`	Menampilkan salinan blob ini.
`getAs(contentType)`	`Blob`	Menampilkan data di dalam objek ini sebagai blob yang dikonversi ke jenis konten yang ditentukan.
`getBytes()`	`Byte[]`	Mendapatkan data yang tersimpan dalam blob ini.
`getContentType()`	`String`	Mendapatkan jenis konten byte dalam blob ini.
`getDataAsString()`	`String`	Mendapatkan data blob ini sebagai String dengan encoding UTF-8.
`getDataAsString(charset)`	`String`	Mendapatkan data blob ini sebagai string dengan encoding yang ditentukan.
`getHash()`	`String`	Mendapatkan hash konten SHA1 untuk lampiran ini.
`getName()`	`String`	Mendapatkan nama blob ini.
`getSize()`	`Integer`	Mendapatkan ukuran lampiran ini.
`isGoogleType()`	`Boolean`	Menampilkan apakah blob ini adalah file Google Workspace (Spreadsheet, Dokumen, dll.).
`setBytes(data)`	`Blob`	Menetapkan data yang disimpan di blob ini.
`setContentType(contentType)`	`Blob`	Menetapkan jenis konten byte dalam blob ini.
`setContentTypeFromExtension()`	`Blob`	Menetapkan jenis konten byte dalam blob ini berdasarkan ekstensi file.
`setDataFromString(string)`	`Blob`	Menetapkan data blob ini dari string dengan encoding UTF-8.
`setDataFromString(string, charset)`	`Blob`	Menetapkan data blob ini dari string dengan encoding yang ditentukan.
`setName(name)`	`Blob`	Menetapkan nama blob ini.

Metode yang tidak digunakan lagi

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`getAllBlobs()`	`Blob[]`	Mendapatkan semua blob yang ada di dalam blob ini (mungkin gabungan).

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, dianggap bahwa bagian nama file yang mengikuti titik terakhir (jika ada) adalah ekstensi yang sudah ada dan harus diganti. Akibatnya, "ShoppingList.12.25.2014" menjadi "ShoppingList.12.25.pdf".

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

Parameter

Nama	Jenis	Deskripsi
`contentType`	`String`	Jenis 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, `'image/bmp'`, `'image/gif'`, `'image/jpeg'`, atau `'image/png'` juga valid.

Return

Blob — Data sebagai blob.

`getBytes()`

Mendapatkan data yang tersimpan dalam blob ini.

Return

Byte[] — Byte yang disimpan.

`getContentType()`

Mendapatkan jenis konten byte dalam 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

Nama	Jenis	Deskripsi
`charset`	`String`	charset yang akan digunakan dalam mengenkode data dalam 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

Boolean — true jika blob ini adalah file Google Workspace; false jika bukan.

`setBytes(data)`

Menetapkan data yang disimpan di blob ini.