이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Class GmailAttachment

Gmail에서 온 첨부파일입니다. 호출보다 빠른 추가 getSize() 메서드가 있다는 점을 제외하고 일반 Blob입니다. getBytes().length인 경우 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());
    }
  }
}

메서드

메서드	반환 유형	간략한 설명
`copyBlob()`	`Blob`	이 blob의 사본을 반환합니다.
`getAs(contentType)`	`Blob`	이 객체 내의 데이터를 지정된 콘텐츠 유형으로 변환된 blob으로 반환합니다.
`getBytes()`	`Byte[]`	이 blob에 저장된 데이터를 가져옵니다.
`getContentType()`	`String`	이 blob에 있는 바이트의 콘텐츠 유형을 가져옵니다.
`getDataAsString()`	`String`	이 blob의 데이터를 UTF-8 인코딩을 사용한 문자열로 가져옵니다.
`getDataAsString(charset)`	`String`	이 blob의 데이터를 지정된 인코딩을 사용한 문자열로 가져옵니다.
`getHash()`	`String`	이 첨부파일의 SHA1 콘텐츠 해시를 가져옵니다.
`getName()`	`String`	이 blob의 이름을 가져옵니다.
`getSize()`	`Integer`	이 첨부파일의 크기를 가져옵니다.
`isGoogleType()`	`Boolean`	이 blob이 Google Workspace 파일 (Sheets, Docs 등)인지 여부를 반환합니다.
`setBytes(data)`	`Blob`	이 blob에 저장된 데이터를 설정합니다.
`setContentType(contentType)`	`Blob`	이 blob에 있는 바이트의 콘텐츠 유형을 설정합니다.
`setContentTypeFromExtension()`	`Blob`	파일 확장자에 따라 이 blob에 있는 바이트의 콘텐츠 유형을 설정합니다.
`setDataFromString(string)`	`Blob`	UTF-8 인코딩을 사용한 문자열에서 이 blob의 데이터를 설정합니다.
`setDataFromString(string, charset)`	`Blob`	지정된 인코딩을 사용하여 문자열에서 이 blob의 데이터를 설정합니다.
`setName(name)`	`Blob`	이 blob의 이름을 설정합니다.

지원 중단된 메서드

메서드	반환 유형	간략한 설명
`getAllBlobs()`	`Blob[]`	이 복합 blob 내에 포함된 모든 blob을 가져옵니다.

자세한 문서

`copyBlob()`

이 blob의 사본을 반환합니다.

리턴

Blob - 새 사본입니다.

`getAs(contentType)`

이 객체 내의 데이터를 지정된 콘텐츠 유형으로 변환된 blob으로 반환합니다. 이 메서드는 파일 이름에 적절한 확장자를 추가합니다(예: 'myfile.pdf'). 하지만 파일 이름에서 마지막 마침표 뒤에 오는 부분 (있는 경우)이 기존 교체해야 합니다. 따라서 'ShoppingList.12.25.2014' 위 이름이 아래와 같이 변경됩니다. 'ShoppingList.12.25.pdf'

전환수의 일일 할당량을 보려면 Google '서비스'로 이동합니다. 새로 생성된 Google Workspace 도메인에는 일시적으로 더 엄격한 정책이 적용될 수 있습니다. 할당량도 제공합니다

매개변수

이름	유형	설명
`contentType`	`String`	변환할 MIME 유형입니다. 대부분의 blob에서 `'application/pdf'`는 다음과 같습니다. 유일하게 유효한 옵션입니다. BMP, GIF, JPEG, PNG 형식의 이미지인 경우 `'image/bmp'`, `'image/gif'`, `'image/jpeg'`, `'image/png'` 중 어느 것이든 해당됩니다. 유효한지 확인합니다. Google Docs 문서의 경우 `'text/markdown'`도 유효합니다.

리턴

Blob - blob 형식의 데이터입니다.

`getBytes()`

이 blob에 저장된 데이터를 가져옵니다.

리턴

Byte[] - 저장된 바이트입니다.

`getContentType()`

이 blob에 있는 바이트의 콘텐츠 유형을 가져옵니다.

리턴

String: 이 데이터의 콘텐츠 유형(알려진 경우) 또는 null입니다.

`getDataAsString()`

이 blob의 데이터를 UTF-8 인코딩을 사용한 문자열로 가져옵니다.

리턴

String - 데이터(문자열)입니다.

`getDataAsString(charset)`

이 blob의 데이터를 지정된 인코딩을 사용한 문자열로 가져옵니다.

매개변수

이름	유형	설명
`charset`	`String`	이 blob의 데이터를 문자열로 인코딩하는 데 사용할 문자 집합입니다.

리턴

String - 데이터(문자열)입니다.

`getHash()`

이 첨부파일의 SHA1 콘텐츠 해시를 가져옵니다. 이 방법은 Gmail에 반영되지 않습니다. 읽기 할당량도 제공합니다

리턴

String - SHA1 콘텐츠 해시(문자열)입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 승인되어야 합니다.

https://mail.google.com/

`getName()`

이 blob의 이름을 가져옵니다.

리턴

String - 이 데이터의 이름(알려진 경우) 또는 null입니다.

`getSize()`

이 첨부파일의 크기를 가져옵니다. 이 방법은 getBytes().length를 호출하는 것보다 빠르며 Gmail 읽기 할당량에 포함되지 않습니다.

리턴

Integer — 바이트 단위의 첨부파일 크기입니다.

승인

이 메서드를 사용하는 스크립트에는 다음 범위 중 하나 이상 또는 관련 REST API의 적절한 범위가 승인되어야 합니다.

https://mail.google.com/

`isGoogleType()`

이 blob이 Google Workspace 파일 (Sheets, Docs 등)인지 여부를 반환합니다.

리턴

Boolean: 이 blob이 Google Workspace 파일인 경우 true 없으면 false입니다.

`setBytes(data)`

이 blob에 저장된 데이터를 설정합니다.

매개변수

이름	유형	설명
`data`	`Byte[]`	새 데이터입니다.

리턴

Blob - 체이닝을 위한 blob입니다.

`setContentType(contentType)`

이 blob에 있는 바이트의 콘텐츠 유형을 설정합니다.

매개변수

이름	유형	설명
`contentType`	`String`	새 contentType입니다.

리턴

Blob - 체이닝을 위한 blob입니다.

`setContentTypeFromExtension()`

파일 확장자에 따라 이 blob에 있는 바이트의 콘텐츠 유형을 설정합니다. contentType은 확장 프로그램에서 추측할 수 없는 경우 null입니다.

리턴

Blob - 체이닝을 위한 blob입니다.

`setDataFromString(string)`

UTF-8 인코딩을 사용한 문자열에서 이 blob의 데이터를 설정합니다.

매개변수

이름	유형	설명
`string`	`String`	문자열 데이터입니다.

리턴

Blob - 체이닝을 위한 blob입니다.

`setDataFromString(string, charset)`

지정된 인코딩을 사용하여 문자열에서 이 blob의 데이터를 설정합니다.

매개변수

이름	유형	설명
`string`	`String`	문자열 데이터입니다.
`charset`	`String`	문자열을 바이트로 해석하는 데 사용할 문자 집합입니다.

리턴

Blob - 체이닝을 위한 blob입니다.

`setName(name)`

이 blob의 이름을 설정합니다.

매개변수

이름	유형	설명
`name`	`String`	새 이름입니다.

리턴

Blob - 체이닝을 위한 blob입니다.

지원 중단된 메서드

`getAllBlobs()`

지원 중단되었습니다. 이 함수는 지원 중단되었으며 새 스크립트에 사용하면 안 됩니다.

이 복합 blob 내에 포함된 모든 blob을 가져옵니다.

리턴

Blob[] - blob에 포함된 blob입니다.