セル内の画像値を表します。セルに画像を追加するには、Spreadsheet
と Cell
を使用して画像の新しい画像値を作成する必要があります。その後、Range.setValue(value)
または Range.setValues(values)
を使用して、画像値をセルに追加できます。
プロパティ
プロパティ | タイプ | 説明 |
---|---|---|
value | Value | セル画像の値の型(Value )。 |
メソッド
メソッド | 戻り値の型 | 概要 |
---|---|---|
get | String | この画像の代替テキストの説明を返します。 |
get | String | この画像の代替テキストのタイトルを返します。 |
get | String | Google がホストする画像の URL を返します。 |
to | Cell | 現在の画像プロパティに基づいてセル画像ビルダーを作成します。 |
詳細なドキュメント
get Alt Text Description()
この画像の代替テキストの説明を返します。
戻る
String
- 代替テキストの説明。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Alt Text Title()
この画像の代替テキストのタイトルを返します。
戻る
String
- 代替テキストのタイトル。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Content Url()
画像の Google ホスト URL を返します。この URL にはリクエスト元のアカウントのタグが付けられているため、URL を知っているユーザーは、元のリクエスト元として画像にアクセスできます。スプレッドシートの共有設定が変更されると、画像にアクセスできなくなる可能性があります。返された URL は、しばらくすると期限切れになります。
const range = SpreadsheetApp.getActiveSpreadsheet().getRange("Sheet1!A1"); const value = range.getValue(); if (value.valueType == SpreadsheetApp.ValueType.IMAGE) { console.log(value.getContentUrl()); }
戻る
String
- Google がホストする画像の URL。
to Builder()
現在の画像プロパティに基づいてセル画像ビルダーを作成します。Cell
を使用して、新しい画像のソース URL を設定します。その後、Range.setValue(value)
または Range.setValues(values)
を使用してセルに追加できます。
const ss = SpreadsheetApp.getActiveSpreadsheet(); const range = ss.getRange("Sheet1!A1"); const value = range.getValue(); if (value.valueType == SpreadsheetApp.ValueType.IMAGE) { const newImage = value.toBuilder() .setSourceUrl( 'https://www.gstatic.com/images/branding/productlogos/apps_script/v10/web-64dp/logo_apps_script_color_1x_web_64dp.png', ) .build(); const newRange = ss.getRange("Sheet1!A2"); newRange.setValue(newImage); }
戻る
Cell
- 指定された画像プロパティに基づいて画像値の型を作成するビルダー。