Class Image

画像

画像を表す PageElement

Methods

メソッド戻り値の型概要
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()voidLink を削除します。
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)LinkLink を指定された Slide に設定します。リンクは指定されたスライド ID によって設定されます。
setLinkSlide(slidePosition)Linkスライドの相対位置を使用して、Link を指定された Slide に設定します。
setLinkUrl(url)LinkLink を指定された空でない URL 文字列に設定します。
setRotation(angle)Image要素の中心を中心とする時計回りの回転角度を度単位で設定します。
setTitle(title)Imageページ要素の代替テキストのタイトルを設定します。
setTop(top)Image要素が回転していないときに、ページの左上隅から測定したポイント単位で要素の垂直位置を設定します。
setTransform(transform)Image指定された変換でページ要素の変換を設定します。
setWidth(width)Image要素の幅をポイント単位で設定します。これは、要素が回転していない場合の要素の境界ボックスの幅です。

詳細なドキュメント

alignOnPage(alignmentPosition)

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

パラメータ

名前説明
alignmentPositionAlignmentPositionページ上のこのページ要素を配置する位置。

リターン

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」になります。

コンバージョンの 1 日あたりの割り当てを確認するには、Google サービスの割り当てをご覧ください。新しく作成された Google Workspace ドメインには、一時的に割り当てが厳しくなることがあります。

パラメータ

名前説明
contentTypeString変換先の MIME タイプ。ほとんどの blob では、有効なオプションは 'application/pdf' のみです。BMP、GIF、JPEG、PNG 形式の画像の場合は、'image/bmp''image/gif''image/jpeg''image/png' のいずれかも有効です。

リターン

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

ページ要素の代替テキストの説明を返します。description はタイトルと組み合わされ、代替テキストの表示と読み上げを行います。

リターン

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

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

var link = shape.getLink();
if (link != null) {
  Logger.log('Shape has a link of type: ' + link.getLinkType());
}

リターン

Link

承認

この方法を使用するスクリプトには、次の 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 ポイント左に移動するには:

element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder()
    .setTranslateX(-36.0)
    .build());

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

パラメータ

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

リターン

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

Link を削除します。

shape.removeLink();

replace(blobSource)

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

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

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

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

パラメータ

名前説明
blobSourceBlobSource画像データ。

リターン

Image - 置換後のこの Image

承認

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

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

replace(blobSource, crop)

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

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

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

パラメータ

名前説明
blobSourceBlobSource画像データ。
cropBooleantrue の場合、既存の画像のサイズに合わせて画像を切り抜きます。そうでない場合は、画像が拡大縮小され、中央に配置されます。

リターン

Image - 置換後のこの Image

承認

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

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

replace(imageUrl)

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

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

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

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

パラメータ

名前説明
imageUrlString画像のダウンロード元の URL。

リターン

Image - 置換後のこの Image

承認

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

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

replace(imageUrl, crop)

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

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

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

パラメータ

名前説明
imageUrlString画像のダウンロード元の URL。
cropBooleantrue の場合、既存の画像のサイズに合わせて画像を切り抜きます。そうでない場合は、画像が拡大縮小され、中央に配置されます。

リターン

Image - 置換後のこの Image

承認

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

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

scaleHeight(ratio)

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

この方法は、すべてのページ要素に対応していません。このメソッドに対応していないページ要素については、 サイズと配置の制限をご覧ください。

パラメータ

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

リターン

Image - このページ要素(チェーン用)。

承認

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

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

scaleWidth(ratio)

指定された比率で要素の幅を拡大縮小します。要素の幅は、要素に回転がない場合の境界ボックスの幅です。

この方法は、すべてのページ要素に対応していません。このメソッドに対応していないページ要素については、 サイズと配置の制限をご覧ください。

パラメータ

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

リターン

Image - このページ要素(チェーン用)。

承認

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

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

select()

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

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

これにより、PageElement の親 Pagecurrent page selection に設定されます。

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var 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 の親 Pagecurrent page selection に設定されます。

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

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

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

これを確認するには、最初に Page.selectAsCurrentPage() を使用して親 Page を選択し、次にそのページのページ要素を選択することをおすすめします。

var 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.
var pageElements = slide.getPageElements();
for (var i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

パラメータ

名前説明
replaceBooleantrue の場合、選択内容は前の選択を置き換えます。それ以外の場合、選択は前の選択に追加されます。

承認

この方法を使用するスクリプトには、次の 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".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

パラメータ

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

リターン

Image - このページの要素。

承認

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

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

setHeight(height)

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

この方法は、すべてのページ要素に対応していません。このメソッドに対応していないページ要素については、 サイズと配置の制限をご覧ください。

パラメータ

名前説明
heightNumber設定するこのページ要素の新しい高さ(ポイント単位)。

リターン

Image - このページ要素(チェーン用)。

承認

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

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

setLeft(left)

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

パラメータ

名前説明
leftNumber設定する新しい水平位置(ポイント単位)。

リターン

Image - このページ要素(チェーン用)。

承認

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

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

setLinkSlide(slideIndex)

スライドのゼロから始まるインデックスを使用して、指定された SlideLink を設定します。

// Set a link to the first slide of the presentation.
shape.setLinkSlide(0);

パラメータ

名前説明
slideIndexIntegerスライドのゼロから始まるインデックス。

リターン

Link - 設定された Link

承認

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

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

setLinkSlide(slide)

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

// Set a link to the first slide of the presentation.
var slide = presentation.getSlides()[0];
shape.setLinkSlide(slide);

パラメータ

名前説明
slideSlideリンクする Slide

リターン

Link - 設定された Link

承認

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

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

setLinkSlide(slidePosition)

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

// Set a link to the first slide of the presentation.
shape.setLinkSlide(SlideApp.SlidePosition.FIRST_SLIDE);

パラメータ

名前説明
slidePositionSlidePosition相対 SlidePosition

リターン

Link - 設定された Link

承認

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

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

setLinkUrl(url)

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

// Set a link to the URL.
shape.setLinkUrl("https://slides.google.com");

パラメータ

名前説明
urlStringURL 文字列。

リターン

Link - 設定された Link

承認

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

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

setRotation(angle)

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

この方法は、すべてのページ要素に対応していません。このメソッドに対応していないページ要素については、 サイズと配置の制限をご覧ください。

パラメータ

名前説明
angleNumber新たに設定する時計回りの回転角度(度数)。

リターン

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".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

パラメータ

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

リターン

Image - このページの要素。

承認

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

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

setTop(top)

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

パラメータ

名前説明
topNumber設定する新しい垂直位置(ポイント単位)。

リターン

Image - このページ要素(チェーン用)。

承認

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

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

setTransform(transform)

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

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

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

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

パラメータ

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

リターン

Image - チェーン用のこの要素。

承認

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

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

setWidth(width)

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

この方法は、すべてのページ要素に対応していません。このメソッドに対応していないページ要素については、 サイズと配置の制限をご覧ください。

パラメータ

名前説明
widthNumber設定するこのページ要素の新しい幅(ポイント単位)。

リターン

Image - このページ要素(チェーン用)。

承認

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

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