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

Class GmailAttachment

Gmail의 첨부파일 이 메서드는 getBytes().length를 호출하는 것보다 빠르고 Gmail 읽기 할당량에 반영되지 않는 추가 getSize() 메서드가 있다는 점을 제외하고는 일반 Blob입니다.

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

메서드

메서드	반환 유형	간략한 설명
`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`	이 블롭이 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`	이 블롭의 이름을 설정합니다.

지원 중단된 메서드

메서드	반환 유형	간략한 설명
`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`	이 블롭의 데이터를 문자열로 인코딩하는 데 사용할 문자 집합입니다.

리턴

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()`

이 블롭이 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 인코딩된 문자열에서 이 블롭의 데이터를 설정합니다.

매개변수

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

리턴

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

`setDataFromString(string, charset)`

지정된 인코딩으로 문자열에서 이 blob의 데이터를 설정합니다.

매개변수

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

리턴

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

`setName(name)`

이 블롭의 이름을 설정합니다.

매개변수

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

리턴

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

지원 중단된 메서드

`getAllBlobs()`

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

이 (합성일 수 있는) blob 내에 포함된 모든 blob을 가져옵니다.

리턴

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