Halaman ini diterjemahkan oleh Cloud Translation API.

Class GmailAttachment

Lampiran dari Gmail. Ini adalah Blob reguler, 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.
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(),
      );
    }
  }
}

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 disimpan 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 dalam 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 terdapat dalam blob ini (mungkin komposit).

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. Metode ini menambahkan ekstensi yang sesuai ke nama file—misalnya, "myfile.pdf". Namun, hal ini menganggap bahwa bagian nama file yang mengikuti titik terakhir (jika ada) adalah ekstensi yang 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 mungkin akan dikenai kuota yang lebih ketat untuk sementara.

Parameter

Nama	Jenis	Deskripsi
`contentType`	`String`	Jenis MIME yang akan dikonversi. 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. Untuk dokumen Google Dokumen, `'text/markdown'` juga valid.

Pulang pergi

Blob — Data sebagai blob.

`getBytes()`

Mendapatkan data yang disimpan dalam 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

Nama	Jenis	Deskripsi
`charset`	`String`	Set 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 mengurangi kuota pembacaan Gmail.

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

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

`setBytes(data)`

Menetapkan data yang disimpan dalam blob ini.