このページは Cloud Translation API によって翻訳されました。

Class Image

画像を表す PageElement。

メソッド

メソッド	戻り値の型	概要
`alignOnPage(alignmentPosition)`	`Image`	ページ上の指定された位置に要素を配置します。
`bringForward()`	`Image`	ページ要素を 1 つ前方に移動します。
`bringToFront()`	`Image`	ページ要素をページの最前面に移動します。
`duplicate()`	`PageElement`	ページ要素を複製します。
`getAs(contentType)`	`Blob`	このオブジェクト内のデータを指定したコンテンツタイプに変換された BLOB として返します。
`getBlob()`	`Blob`	この画像内のデータを BLOB として返します。
`getBorder()`	`Border`	画像の `Border` を返します。
`getConnectionSites()`	`ConnectionSite[]`	ページ要素の `ConnectionSite` のリスト、またはページ要素に接続サイトがない場合は空のリストを返します。
`getContentUrl()`	`String`	画像の URL を取得します。
`getDescription()`	`String`	ページ要素の代替テキストの説明を返します。
`getHeight()`	`Number`	要素の高さをポイント単位で取得します。これは、要素が回転していない場合の要素の境界ボックスの高さです。
`getInherentHeight()`	`Number`	要素固有の高さをポイント単位で返します。
`getInherentWidth()`	`Number`	要素の固有の幅をポイント単位で返します。
`getLeft()`	`Number`	要素の水平位置をピクセル単位で返します。要素が回転していない場合は、ページの左上隅から測定されます。
`getLink()`	`Link`	リンクがない場合、`Link` または `null` を返します。
`getObjectId()`	`String`	このオブジェクトの一意の ID を返します。
`getPageElementType()`	`PageElementType`	ページ要素のタイプを `PageElementType` 列挙型で返します。
`getParentGroup()`	`Group`	このページ要素が属するグループを返します。要素がグループに属していない場合は `null` を返します。
`getParentPage()`	`Page`	このページ要素が配置されているページを返します。
`getParentPlaceholder()`	`PageElement`	プレースホルダの親ページ要素を返します。
`getPlaceholderIndex()`	`Integer`	プレースホルダ画像のインデックスを返します。
`getPlaceholderType()`	`PlaceholderType`	画像のプレースホルダタイプを返します。シェイプがプレースホルダでない場合は `PlaceholderType.NONE` を返します。
`getRotation()`	`Number`	要素の中心を中心とした時計回りの回転角度を度数で返します。0 度は回転なしを意味します。
`getSourceUrl()`	`String`	画像のソース URL（利用可能な場合）を取得します。
`getTitle()`	`String`	ページ要素の代替テキストのタイトルを返します。
`getTop()`	`Number`	要素の垂直位置をポイント単位で取得します。要素が回転していない場合は、ページの左上隅から測定されます。
`getTransform()`	`AffineTransform`	ページ要素の変換を返します。
`getWidth()`	`Number`	要素の幅をポイント単位で返します。これは、要素が回転していない場合の要素の境界ボックスの幅です。
`preconcatenateTransform(transform)`	`Image`	指定された変換を、ページ要素の既存の変換に事前に連結します。
`remove()`	`void`	ページ要素を削除します。
`removeLink()`	`void`	`Link` を削除します。
`replace(blobSource)`	`Image`	この画像を、`BlobSource` オブジェクトで記述された画像に置き換えます。
`replace(blobSource, crop)`	`Image`	この画像を `Image` オブジェクトで記述された画像に置き換えます。必要に応じて、画像をトリミングして収まるようにします。
`replace(imageUrl)`	`Image`	この画像を、指定された URL からダウンロードした別の画像に置き換えます。
`replace(imageUrl, crop)`	`Image`	この画像を、指定された URL からダウンロードした別の画像に置き換えます。必要に応じて、画像をトリミングして収まるようにします。
`scaleHeight(ratio)`	`Image`	指定された比率で要素の高さをスケーリングします。
`scaleWidth(ratio)`	`Image`	要素の幅を指定された比率でスケーリングします。
`select()`	`void`	アクティブなプレゼンテーション内の `PageElement` のみを選択し、以前の選択内容をすべて削除します。
`select(replace)`	`void`	アクティブなプレゼンテーションの `PageElement` を選択します。
`sendBackward()`	`Image`	ページ要素をページ上で 1 つ後方に移動します。
`sendToBack()`	`Image`	ページ要素をページの一番後ろに移動します。
`setDescription(description)`	`Image`	ページ要素の代替テキストの説明を設定します。
`setHeight(height)`	`Image`	要素の高さをポイント単位で設定します。これは、要素が回転していない場合の要素の境界ボックスの高さです。
`setLeft(left)`	`Image`	要素の水平位置をポイント単位で設定します。要素が回転していない場合は、ページの左上隅から測定されます。
`setLinkSlide(slideIndex)`	`Link`	スライドのゼロベースのインデックスを使用して、`Link` を指定された `Slide` に設定します。
`setLinkSlide(slide)`	`Link`	指定された `Slide` に `Link` を設定します。リンクは指定されたスライド ID によって設定されます。
`setLinkSlide(slidePosition)`	`Link`	スライドの相対位置を使用して、指定された `Slide` に `Link` を設定します。
`setLinkUrl(url)`	`Link`	指定された空でない URL 文字列に `Link` を設定します。
`setRotation(angle)`	`Image`	要素の中心を中心として時計回りに回転する角度を度単位で設定します。
`setTitle(title)`	`Image`	ページ要素の代替テキストのタイトルを設定します。
`setTop(top)`	`Image`	要素の垂直位置をポイント単位で設定します。要素が回転していない場合は、ページの左上隅から測定されます。
`setTransform(transform)`	`Image`	指定された変換でページ要素の変換を設定します。
`setWidth(width)`	`Image`	要素の幅をポイント単位で設定します。これは、要素が回転していない場合の要素の境界ボックスの幅です。

詳細なドキュメント

`alignOnPage(alignmentPosition)`

ページ上の指定された位置に要素を配置します。

パラメータ

名前	型	説明
`alignmentPosition`	`AlignmentPosition`	このページ要素をページ上で配置する位置。

戻る

Image - このページ要素（チェーン用）。

`bringForward()`

ページ要素をページ上で 1 つ前方に移動します。

ページ要素はグループに含めることはできません。

戻る

Image - このページ要素（チェーン用）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`bringToFront()`

ページ要素をページの最前面に移動します。

ページ要素はグループに含めることはできません。

戻る

Image - このページ要素（チェーン用）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`duplicate()`

ページ要素を複製します。

重複するページ要素は、元のページ要素と同じ位置に配置されます。

戻る

PageElement - このページ要素の新しい重複。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`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 ドキュメントドキュメントの場合は、`'text/markdown'` も有効です。

戻る

Blob - BLOB としてのデータ。

`getBlob()`

この画像内のデータを BLOB として返します。

戻る

Blob - blob としての画像データ。

`getBorder()`

画像の Border を返します。

戻る

Border - 画像の枠線。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getConnectionSites()`

ページ要素の ConnectionSite のリスト、またはページ要素に接続サイトがない場合は空のリストを返します。

戻る

ConnectionSite[] - 接続サイトのリスト。この要素に接続サイトがない場合、空になることがあります。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getContentUrl()`

画像の URL を取得します。

この URL にはリクエスト元のアカウントのタグが付けられているため、URL を知っているユーザーは誰でも、元のリクエスト元として画像にアクセスできます。プレゼンテーションの共有設定が変更されると、画像にアクセスできなくなる可能性があります。返された URL は、しばらくすると期限切れになります。

戻る

String

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getDescription()`

ページ要素の代替テキストの説明を返します。説明はタイトルと組み合わせて、代替テキストとして表示および読み上げられます。

戻る

String - ページ要素の代替テキストの説明。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getHeight()`

要素の高さをポイント単位で取得します。これは、要素が回転していない場合の要素の境界ボックスの高さです。

この方法は、すべてのページ要素に対応しているわけではありません。この方法に対応していないページ要素については、サイズと配置の制限事項をご覧ください。

戻る

Number - ページ要素固有の高さ（ポイント単位）。ページ要素に高さがない場合は null です。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getInherentHeight()`

要素固有の高さをポイント単位で返します。

ページ要素の変換は、その固有のサイズを基準としています。要素の変換と組み合わせて固有のサイズを使用して、要素の最終的な外観を決定します。

戻る

Number - ページ要素固有の高さ（ポイント単位）。ページ要素に高さがない場合は null です。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getInherentWidth()`

要素の固有の幅をポイント単位で返します。

戻る

Number - ページ要素固有の幅（ポイント単位）。ページ要素に幅がない場合は null です。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getLeft()`

要素の水平位置をピクセル単位で返します。要素が回転していない場合は、ページの左上隅から測定されます。

戻る

Number - この要素の水平位置（ページの左上からのピクセル単位）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getLink()`

リンクがない場合、Link または null を返します。

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const link = shape.getLink();
if (link != null) {
  Logger.log(`Shape has a link of type: ${link.getLinkType()}`);
}

戻る

Link - Link。リンクがない場合、null。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getObjectId()`

このオブジェクトの一意の ID を返します。ページとページ要素で使用されるオブジェクト ID は同じ名前空間を共有します。

戻る

String - このオブジェクトの一意の ID。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getPageElementType()`

ページ要素のタイプを PageElementType 列挙型で返します。

戻る

PageElementType - ページ要素のタイプ。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParentGroup()`

このページ要素が属するグループを返します。要素がグループに属していない場合は null を返します。

戻る

Group - このページ要素が属するグループ（null）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParentPage()`

このページ要素が配置されているページを返します。

戻る

Page - この要素が存在するページ。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParentPlaceholder()`

プレースホルダの親ページ要素を返します。画像がプレースホルダでないか、親がない場合は null を返します。

戻る

PageElement - この画像プレースホルダの親ページ要素。この画像がプレースホルダでないか、親がない場合は null です。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getPlaceholderIndex()`

プレースホルダ画像のインデックスを返します。同じページの複数のプレースホルダ画像が同じタイプの場合、それぞれに固有のインデックス値が割り当てられます。画像がプレースホルダでない場合、null を返します。

戻る

Integer - この画像のプレースホルダインデックス。画像がプレースホルダでない場合は null です。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getPlaceholderType()`

画像のプレースホルダタイプを返します。シェイプがプレースホルダでない場合は PlaceholderType.NONE を返します。

戻る

PlaceholderType - この画像のプレースホルダタイプ。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getRotation()`

要素の中心を中心とした時計回りの回転角度を度数で返します。0 度は回転なしを意味します。

戻る

Number - 回転角度（0 ～ 360 度）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getSourceUrl()`

画像のソース URL（利用可能な場合）を取得します。

画像が URL で挿入された場合は、画像の挿入時に指定された URL を返します。

戻る

String - 画像の URL。画像にソース URL がない場合は null。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getTitle()`

ページ要素の代替テキストのタイトルを返します。タイトルは説明と組み合わせて、代替テキストとして表示および読み上げられます。

戻る

String - ページ要素の代替テキストのタイトル。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getTop()`

要素の垂直位置をポイント単位で取得します。要素が回転していない場合は、ページの左上隅から測定されます。

戻る

Number - この要素の垂直位置（ページの左上から）。単位はポイントです。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getTransform()`

ページ要素の変換を返します。

ページ要素の視覚的な外観は、その絶対変換によって決まります。絶対変換を計算するには、ページ要素の変換と、そのすべての親グループの変換を事前に連結します。ページ要素がグループにない場合、その絶対変換は、このフィールドの値と同じです。

戻る

AffineTransform - ページ要素の変換。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getWidth()`

要素の幅をポイント単位で返します。これは、要素が回転していない場合の要素の境界ボックスの幅です。

戻る

Number - ページ要素固有の幅（ポイント単位）。ページ要素に幅がない場合は null です。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`preconcatenateTransform(transform)`

指定された変換を、ページ要素の既存の変換に事前に連結します。

newTransform = argument * existingTransform;

たとえば、ページ要素を 36 ポイント左に移動するには、次のようにします。

const element = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
element.preconcatenateTransform(
    SlidesApp.newAffineTransformBuilder().setTranslateX(-36.0).build(),
);

ページ要素の変換を setTransform(transform) に置き換えることもできます。

パラメータ

名前	型	説明
`transform`	`AffineTransform`	このページ要素の変換に事前に連結する変換。

戻る

Image - このページ要素（チェーン用）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`remove()`

ページ要素を削除します。

削除オペレーション後に Group にページ要素が 1 つしか含まれていない場合、またはページ要素が含まれていない場合は、グループ自体も削除されます。

マスターまたはレイアウトでプレースホルダ PageElement が削除されると、空の継承プレースホルダも削除されます。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`removeLink()`

Link を削除します。

const slides = SlidesApp.getActivePresentation().getSlides();
slides[1].getShapes()[0].removeLink();

`replace(blobSource)`

この画像を、BlobSource オブジェクトで記述された画像に置き換えます。

画像を挿入すると、その画像が BlobSource から 1 回取得され、コピーが保存されてプレゼンテーション内に表示されます。画像のサイズは 50 MB 未満で、25 メガピクセルを超えてはなりません。また、PNG、JPEG、GIF のいずれかの形式である必要があります。

画像のアスペクト比を維持するため、画像は既存の画像のサイズに合わせてスケーリングされ、中央に配置されます。

const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById("123abc");
image.replace(driveImage);

パラメータ

名前	型	説明
`blobSource`	`BlobSource`	画像データ。

戻る

Image - 交換後の Image。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`replace(blobSource, crop)`

この画像を Image オブジェクトで記述された画像に置き換えます。必要に応じて、画像を切り抜いて収まるようにします。

const image = SlidesApp.getActivePresentation().getSlides()[0].getImages()[0];
// Get the Drive image file with the given ID.
const driveImage = DriveApp.getFileById('123abc');
// Replace and crop the drive image.
image.replace(driveImage, true);

パラメータ

名前	型	説明
`blobSource`	`BlobSource`	画像データ。
`crop`	`Boolean`	`true` の場合、既存の画像のサイズに合わせて画像が切り抜かれます。それ以外の場合、画像は拡大され、中央に配置されます。

戻る

Image - 交換後の Image。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`replace(imageUrl)`

この画像を、指定された URL からダウンロードした別の画像に置き換えます。

画像を挿入すると、その画像が URL から 1 回取得され、プレゼンテーション内に表示するためのコピーが保存されます。画像のサイズは 50 MB 未満で、25 メガピクセルを超えてはなりません。また、PNG、JPEG、GIF のいずれかの形式である必要があります。

指定する URL は一般公開されており、2 KB 以下である必要があります。URL 自体は画像とともに保存され、getSourceUrl() を介して公開されます。

画像のアスペクト比を維持するため、画像は既存の画像のサイズに合わせてスケーリングされ、中央に配置されます。

パラメータ

名前	型	説明
`imageUrl`	`String`	画像をダウンロードする URL。

戻る

Image - 交換後の Image。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`replace(imageUrl, crop)`

この画像を、指定された URL からダウンロードした別の画像に置き換えます。必要に応じて、画像を切り抜いて収まるようにします。

指定する URL は 2 KB 以下にする必要があります。

パラメータ

名前	型	説明
`imageUrl`	`String`	画像をダウンロードする URL。
`crop`	`Boolean`	`true` の場合、既存の画像のサイズに合わせて画像が切り抜かれます。それ以外の場合、画像は拡大され、中央に配置されます。

戻る

Image - 交換後の Image。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`scaleHeight(ratio)`

指定された比率で要素の高さをスケーリングします。要素の高さは、要素が回転していない場合の境界ボックスの高さです。

パラメータ

名前	型	説明
`ratio`	`Number`	このページ要素の高さをスケーリングする比率。

戻る

Image - このページ要素（チェーン用）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`scaleWidth(ratio)`

要素の幅を指定された比率でスケーリングします。要素の幅は、要素が回転していない場合の境界ボックスの幅です。

パラメータ

名前	型	説明
`ratio`	`Number`	このページ要素の幅をスケーリングする比率。

戻る

Image - このページ要素（チェーン用）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`select()`

アクティブなプレゼンテーション内の PageElement のみを選択し、以前の選択内容をすべて削除します。これは、true で select(replace) を呼び出す場合と同じです。

スクリプトは、スクリプトを実行しているユーザーの選択にのみアクセスできます。ただし、スクリプトがプレゼンテーションにバインドされている場合に限られます。

これにより、PageElement の親 Page が current page selection として設定されます。

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`select(replace)`

アクティブなプレゼンテーションの PageElement を選択します。

このメソッドに true を渡して、PageElement のみを選択し、以前の選択をすべて削除します。また、PageElement の親 Page が current page selection として設定されます。

false を渡して、複数の PageElement オブジェクトを選択します。PageElement オブジェクトは同じ Page に存在する必要があります。

false パラメータを使用してページ要素を選択する際は、次の条件を満たしている必要があります。

PageElement オブジェクトの親 Page は current page selection である必要があります。
複数の Page オブジェクトを選択しないでください。

これが確実に行われるようにするには、まず Page.selectAsCurrentPage() を使用して親 Page を選択し、そのページ内のページ要素を選択することをおすすめします。

const slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
const pageElements = slide.getPageElements();
for (let i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

パラメータ

名前	型	説明
`replace`	`Boolean`	`true` の場合、選択内容は以前の選択内容に置き換えられます。それ以外の場合は、選択内容は以前の選択内容に追加されます。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`sendBackward()`

ページ要素をページ上で 1 つ後方に移動します。

ページ要素はグループに含めることはできません。

戻る

Image - このページ要素（チェーン用）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`sendToBack()`

ページ要素をページの一番後ろに移動します。

ページ要素はグループに含めることはできません。

戻る

Image - このページ要素（チェーン用）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setDescription(description)`

ページ要素の代替テキストの説明を設定します。

このメソッドは、Group 要素ではサポートされていません。

// Set the first page element's alt text description to "new alt text
// description".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

パラメータ

名前	型	説明
`description`	`String`	代替テキストの説明を設定する文字列。

戻る

Image - このページの要素。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setHeight(height)`

要素の高さをポイント単位で設定します。これは、要素が回転していない場合の要素の境界ボックスの高さです。

パラメータ

名前	型	説明
`height`	`Number`	設定するこのページ要素の新しい高さ（ポイント単位）。

戻る

Image - このページ要素（チェーン用）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLeft(left)`

要素の水平位置をポイント単位で設定します。要素が回転していない場合は、ページの左上隅から測定されます。

パラメータ

名前	型	説明
`left`	`Number`	設定する新しい水平位置（ポイント単位）。

戻る

Image - このページ要素（チェーン用）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkSlide(slideIndex)`

スライドのゼロベースのインデックスを使用して、Link を指定された Slide に設定します。

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(0);

パラメータ

名前	型	説明
`slideIndex`	`Integer`	スライドのゼロベースのインデックス。

戻る

Link - 設定された Link。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkSlide(slide)`

指定された Slide に Link を設定します。リンクは指定されたスライド ID によって設定されます。

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(slides[0]);

パラメータ

名前	型	説明
`slide`	`Slide`	リンクする `Slide`。

戻る

Link - 設定された Link。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkSlide(slidePosition)`

スライドの相対位置を使用して、指定された Slide に Link を設定します。

// Set a link to the first slide of the presentation.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

パラメータ

名前	型	説明
`slidePosition`	`SlidePosition`	相対的な `SlidePosition`。

戻る

Link - 設定された Link。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLinkUrl(url)`

指定された空でない URL 文字列に Link を設定します。

// Set a link to the URL.
const slides = SlidesApp.getActivePresentation().getSlides();
const shape = slides[1].getShapes()[0];
const link = shape.setLinkUrl('https://slides.google.com');

パラメータ

名前	型	説明
`url`	`String`	URL 文字列。

戻る

Link - 設定された Link。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setRotation(angle)`

要素の中心を中心とした時計回りの回転角度を度単位で設定します。

パラメータ

名前	型	説明
`angle`	`Number`	設定する新しい時計回りの回転角度（度）。

戻る

Image - このページ要素（チェーン用）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setTitle(title)`

ページ要素の代替テキストのタイトルを設定します。

このメソッドは、Group 要素ではサポートされていません。

// Set the first page element's alt text title to "new alt text title".
const pageElement =
    SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

パラメータ

名前	型	説明
`title`	`String`	代替テキストのタイトルを設定する文字列。

戻る

Image - このページの要素。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setTop(top)`

要素の垂直位置をポイント単位で設定します。要素が回転していない場合は、ページの左上隅から測定されます。

パラメータ

名前	型	説明
`top`	`Number`	設定する新しい垂直位置（ポイント単位）。

戻る

Image - このページ要素（チェーン用）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setTransform(transform)`

指定された変換でページ要素の変換を設定します。

グループの変換を更新すると、そのグループ内のページ要素の絶対変換が変更され、外観が変化する可能性があります。

グループ内のページ要素の変換を更新しても、そのページ要素の変換のみが変更され、グループの変換やグループ内の他のページ要素の変換には影響しません。

変換がページ要素の外観に与える影響の詳細については、getTransform() をご覧ください。

パラメータ

名前	型	説明
`transform`	`AffineTransform`	このページ要素に設定されている変換。

戻る

Image - チェーン用の要素。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setWidth(width)`

要素の幅をポイント単位で設定します。これは、要素に回転がない場合の要素の境界ボックスの幅です。

パラメータ

名前	型	説明
`width`	`Number`	設定するこのページ要素の新しい幅（ポイント単位）。

戻る

Image - このページ要素（チェーン用）。

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations