Class GmailAttachment

Załącznik z Gmaila. Jest to zwykła Blob, z tym że ma dodatkową metodę getSize(), która jest szybsza niż wywoływanie getBytes().length i nie jest wliczana do limitu odczytu Gmaila.

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

Metody

Metoda	Zwracany typ	Krótki opis
`copyBlob()`	`Blob`	Zwraca kopię tego obiektu blob.
`getAs(contentType)`	`Blob`	Zwraca dane w tym obiekcie jako obiekt blob przekonwertowany na określony typ treści.
`getBytes()`	`Byte[]`	Pobiera dane przechowywane w tym obiekcie blob.
`getContentType()`	`String\|null`	Pobiera typ zawartości bajtów w tym obiekcie blob.
`getDataAsString()`	`String`	Pobiera dane tego obiektu blob jako ciąg znaków z kodowaniem UTF-8.
`getDataAsString(charset)`	`String`	Pobiera dane tego obiektu blob jako ciąg znaków z określonym kodowaniem.
`getHash()`	`String`	Pobiera identyfikator SHA1 treści tego załącznika.
`getName()`	`String\|null`	Pobiera nazwę tego obiektu blob.
`getSize()`	`Integer`	Pobiera rozmiar tego załącznika.
`isGoogleType()`	`Boolean`	Zwraca informację, czy ten obiekt blob jest plikiem Google Workspace (Arkuszami, Dokumentami itp.).
`setBytes(data)`	`Blob`	Ustawia dane przechowywane w tym obiekcie blob.
`setContentType(contentType)`	`Blob`	Ustawia typ treści bajtów w tym obiekcie blob.
`setContentTypeFromExtension()`	`Blob`	Ustawia typ treści bajtów w tym obiekcie blob na podstawie rozszerzenia pliku.
`setDataFromString(string)`	`Blob`	Ustawia dane tego obiektu blob na podstawie ciągu znaków zakodowanego w UTF-8.
`setDataFromString(string, charset)`	`Blob`	Ustawia dane tego obiektu blob na podstawie ciągu znaków z określonym kodowaniem.
`setName(name)`	`Blob`	Ustawia nazwę tego obiektu blob.

Wycofane metody

Metoda	Zwracany typ	Krótki opis
`getAllBlobs()`	`Blob[]`	Pobiera wszystkie obiekty blob zawarte w tym (prawdopodobnie złożonym) obiekcie blob.

Szczegółowa dokumentacja

`copyBlob()`

Zwraca kopię tego obiektu blob.

Powrót

Blob – nowy tekst.

`getAs(contentType)`

Zwraca dane w tym obiekcie jako obiekt blob przekonwertowany na określony typ treści. Ta metoda dodaje do nazwy pliku odpowiednie rozszerzenie, np. „mójplik.pdf”. Zakłada jednak, że część nazwy pliku, która następuje po ostatniej kropce (jeśli występuje), jest istniejącym rozszerzeniem, które należy zastąpić. W konsekwencji nazwa „ShoppingList.12.25.2014” zmieni się na „ShoppingList.12.25.pdf”.

Aby wyświetlić dzienne limity konwersji, zapoznaj się z artykułem Limity usług Google. Nowo utworzone domeny Google Workspace mogą być tymczasowo objęte bardziej rygorystycznymi limitami.

Parametry

Nazwa	Typ	Opis
`contentType`	`String`	Typ MIME, na który ma zostać przekonwertowany plik. W przypadku większości obiektów blob jedyną prawidłową opcją jest `'application/pdf'`. W przypadku obrazów w formacie BMP, GIF, JPEG lub PNG prawidłowe są też znaki `'image/bmp'`, `'image/gif'`, `'image/jpeg'` i `'image/png'`. W przypadku dokumentu Google `'text/markdown'` jest również prawidłowy.

Powrót

Blob – dane w formie obiektu blob.

`getBytes()`

Pobiera dane przechowywane w tym obiekcie blob.

Powrót

Byte[] – przechowywane bajty.

`getContentType()`

Pobiera typ zawartości bajtów w tym obiekcie blob.

Powrót

String|null – typ treści tych danych, jeśli jest znany, lub null.

`getDataAsString()`

Pobiera dane tego obiektu blob jako ciąg znaków z kodowaniem UTF-8.

Powrót

String – dane w postaci ciągu znaków.

`getDataAsString(charset)`

Pobiera dane tego obiektu blob jako ciąg znaków z określonym kodowaniem.

Parametry

Nazwa	Typ	Opis
`charset`	`String`	Zestaw znaków, który ma być używany do kodowania danych w tym obiekcie blob jako ciągu znaków.

Powrót

String – dane w postaci ciągu znaków.

`getHash()`

Pobiera identyfikator SHA1 treści tego załącznika. Ta metoda nie jest wliczana do limitu odczytu Gmaila.

Powrót

String – identyfikator SHA1 treści w postaci ciągu znaków.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

https://mail.google.com/

`getName()`

Pobiera nazwę tego obiektu blob.

Powrót

String|null – nazwa tych danych, jeśli jest znana, lub null.

`getSize()`

Pobiera rozmiar tego załącznika. Ta metoda jest szybsza niż wywoływanie funkcji getBytes().length i nie wlicza się do limitu odczytu Gmaila.

Powrót

Integer – rozmiar załącznika w bajtach.

Autoryzacja

Skrypty, które używają tej metody, wymagają autoryzacji za pomocą co najmniej jednego z tych zakresów lub odpowiednich zakresów z powiązanego interfejsu API REST:

https://mail.google.com/

`isGoogleType()`

Zwraca informację, czy ten obiekt blob jest plikiem Google Workspace (Arkuszami, Dokumentami itp.).

Powrót

Boolean – true, jeśli ten obiekt blob jest plikiem Google Workspace; false, jeśli nie.

`setBytes(data)`

Ustawia dane przechowywane w tym obiekcie blob.