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()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 Cloud の割り当て サービス。新しく作成された Google Workspace ドメインには一時的に厳格な できます。

パラメータ

名前型説明
contentTypeString変換先の 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

リンクがない場合は 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 は、 Namespace があります。

戻る

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 を 1 回呼び出すと、プレゼンテーション内に表示するためにコピーが保存されます。 画像は、サイズが 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 を 1 回呼び出すと、プレゼンテーション内に表示するためにコピーが保存されます。 画像は、サイズが 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 から 1 回取得され、画像のコピーが保存されて 説明します。画像のサイズは 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 から 1 回取得され、画像のコピーが保存されて 説明します。画像のサイズは 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 の親 Page が current 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 の親 Page が current page selection。

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

false を使用してページ要素を選択する場合は、次の条件を満たす必要があります parameter:

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

これを実現するには、親 Page を選択することをおすすめします。 まず Page.selectAsCurrentPage() を使用してから、そのページのページ要素を選択します。 

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)

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

// 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