Class Image

Resim

Bir resmi temsil eden PageElement.

Yöntemler

YöntemDönüş türüKısa açıklama
alignOnPage(alignmentPosition)ImageÖğeyi sayfada belirtilen hizalama konumuna hizalar.
bringForward()ImageSayfa öğesini sayfada bir öğe öne getirir.
bringToFront()ImageSayfa öğesini sayfanın önüne getirir.
duplicate()PageElementSayfa öğesini çoğaltır.
getAs(contentType)BlobBu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürün.
getBlob()BlobBu görüntüdeki verileri blob olarak döndürün.
getBorder()BorderResmin Border değerini döndürür.
getConnectionSites()ConnectionSite[]Sayfa öğesindeki ConnectionSite listesini veya sayfa öğesinin bağlantı sitesi yoksa boş bir liste döndürür.
getContentUrl()StringResmin URL'sini alır.
getDescription()StringSayfa öğesinin alternatif metin açıklamasını döndürür.
getHeight()NumberÖğenin yüksekliğini noktalar halinde alır. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun yüksekliğidir.
getInherentHeight()NumberÖğenin doğal yüksekliğini puan cinsinden döndürür.
getInherentWidth()NumberÖğenin doğal genişliğini nokta cinsinden döndürür.
getLeft()NumberÖğe hiç dönmediğinde sayfanın sol üst köşesinden ölçülen, öğenin yatay konumunu noktalar cinsinden döndürür.
getLink()LinkBağlantı yoksa Link veya null değerini döndürür.
getObjectId()StringBu nesnenin benzersiz kimliğini döndürür.
getPageElementType()PageElementTypeSayfa öğesinin PageElementType sıralamasıyla belirtilen türünü döndürür.
getParentGroup()GroupBu sayfa öğesinin ait olduğu grubu veya öğe bir grupta yer almıyorsa null değerini döndürür.
getParentPage()PageBu sayfa öğesinin bulunduğu sayfayı döndürür.
getParentPlaceholder()PageElementYer tutucunun üst sayfa öğesini döndürür.
getPlaceholderIndex()IntegerYer tutucu resmin dizinini döndürür.
getPlaceholderType()PlaceholderTypeResmin yer tutucu türünü veya şekil bir yer tutucu değilse PlaceholderType.NONE değerini döndürür.
getRotation()NumberÖğenin merkezi çevresindeki saat yönünde dönme açısını derece cinsinden döndürür. Sıfır derece, dönüş olmadığı anlamına gelir.
getSourceUrl()StringVarsa resmin kaynak URL'sini alır.
getTitle()StringSayfa öğesinin alternatif metin başlığını döndürür.
getTop()NumberÖğe döndürme olduğunda sayfanın sol üst köşesinden ölçülen, öğenin dikey konumunu noktalar cinsinden alır.
getTransform()AffineTransformSayfa öğesinin dönüşümünü döndürür.
getWidth()NumberÖğenin genişliğini, nokta cinsinden döndürür. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun genişliğidir.
preconcatenateTransform(transform)ImageSağlanan dönüşümü, sayfa öğesinin mevcut dönüşümüyle önceden birleştirir.
remove()voidSayfa öğesini kaldırır.
removeLink()voidBir Link kaldırır.
replace(blobSource)ImageBu resmi, BlobSource nesnesi tarafından açıklanan bir resimle değiştirir.
replace(blobSource, crop)ImageBu resmi, Image nesnesi tarafından açıklanan bir resimle değiştirir ve isteğe bağlı olarak resmi sığacak şekilde kırpar.
replace(imageUrl)ImageBu resmi, sağlanan URL'den indirilen başka bir resimle değiştirir.
replace(imageUrl, crop)ImageBu resmi, sağlanan URL'den indirilen başka bir resimle değiştirir ve isteğe bağlı olarak resmi sığacak şekilde kırpar.
scaleHeight(ratio)ImageÖğenin yüksekliğini belirtilen orana göre ölçeklendirir.
scaleWidth(ratio)ImageÖğenin genişliğini belirtilen orana göre ölçeklendirir.
select()voidEtkin sunuda yalnızca PageElement öğesini seçer ve önceki seçimleri kaldırır.
select(replace)voidEtkin sunuda PageElement öğesini seçer.
sendBackward()ImageSayfa öğesini bir öğe tarafından sayfada geriye doğru gönderir.
sendToBack()ImageSayfa öğesini sayfanın arkasına gönderir.
setDescription(description)ImageSayfa öğesinin alternatif metin açıklamasını ayarlar.
setHeight(height)ImageÖğenin yüksekliğini noktalar halinde ayarlar. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun yüksekliğidir.
setLeft(left)ImageÖğenin yatay konumunu, öğe döndürme olduğunda sayfanın sol üst köşesinden ölçülen noktalar cinsinden ayarlar.
setLinkSlide(slideIndex)LinkSlaytın sıfır tabanlı dizinini kullanarak bir Link öğesini belirtilen Slide olarak ayarlar.
setLinkSlide(slide)LinkLink öğesini belirtilen Slide değerine ayarlarsa bağlantı, belirtilen slayt kimliğine göre ayarlanır.
setLinkSlide(slidePosition)LinkSlaytın göreli konumunu kullanarak belirli bir Slide için Link ayarlar.
setLinkUrl(url)LinkBelirli boş olmayan URL dizesine Link ayarlar.
setRotation(angle)ImageÖğenin merkezi etrafında saat yönünde dönme açısını derece cinsinden ayarlar.
setTitle(title)ImageSayfa öğesinin alternatif metin başlığını ayarlar.
setTop(top)ImageÖğe döndürme olduğunda, sayfanın sol üst köşesinden ölçülen, öğenin dikey konumunu noktalar cinsinden ayarlar.
setTransform(transform)ImageSağlanan dönüşümle sayfa öğesinin dönüşümünü ayarlar.
setWidth(width)ImageÖğenin genişliğini, noktalar halinde ayarlar. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun genişliğidir.

Ayrıntılı belgeler

alignOnPage(alignmentPosition)

Öğeyi sayfada belirtilen hizalama konumuna hizalar.

Parametreler

AdTürAçıklama
alignmentPositionAlignmentPositionBu sayfa öğesinin sayfada hizalanacağı konum.

Return

Image: Zincirleme için bu sayfa öğesi.


bringForward()

Sayfa öğesini sayfada bir öğe öne getirir.

Sayfa öğesi bir grupta olmamalıdır.

Return

Image: Zincirleme için bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

bringToFront()

Sayfa öğesini sayfanın önüne getirir.

Sayfa öğesi bir grupta olmamalıdır.

Return

Image: Zincirleme için bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

duplicate()

Sayfa öğesini çoğaltır.

Sayfa kopyası öğesi aynı sayfaya, orijinalle aynı konuma yerleştirilir.

Return

PageElement - Bu sayfa öğesinin yeni kopyası.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getAs(contentType)

Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürün. Bu yöntem, dosya adına uygun uzantıyı ekler (örneğin, "dosyam.pdf"). Bununla birlikte, dosya adında son noktanın ardından gelen bölümün (varsa) değiştirilmesi gereken mevcut bir uzantı olduğu varsayılır. Sonuç olarak, "ShoppingList.12.25.2014", "ShoppingList.12.25.pdf" haline gelir.

Günlük dönüşüm kotalarını görüntülemek için Google Hizmetleri Kotalar bölümüne bakın. Yeni oluşturulan Google Workspace alanları geçici olarak daha sıkı kotalara tabi olabilir.

Parametreler

AdTürAçıklama
contentTypeStringDönüştürülecek MIME türü. Çoğu blob için geçerli tek seçenek 'application/pdf''tir. BMP, GIF, JPEG veya PNG biçimindeki resimler için 'image/bmp', 'image/gif', 'image/jpeg' veya 'image/png' değerleri de geçerlidir.

Return

Blob: Blob halinde veriler.


getBlob()

Bu görüntüdeki verileri blob olarak döndürün.

Return

Blob: Görüntü verilerini blob olarak gösterir.


getBorder()

Resmin Border değerini döndürür.

Return

Border: Resmin kenarlığı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getConnectionSites()

Sayfa öğesindeki ConnectionSite listesini veya sayfa öğesinin bağlantı sitesi yoksa boş bir liste döndürür.

Return

ConnectionSite[]: Bağlantı siteleri listesi. Bu öğenin bağlantı sitesi yoksa boş olabilir.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getContentUrl()

Resmin URL'sini alır.

Bu URL, istek sahibinin hesabıyla etiketlenir. Böylece URL'ye sahip herkes, resme orijinal istek sahibi olarak etkili bir şekilde erişir. Sununun paylaşım ayarları değişirse resme erişim kaybedilebilir. Döndürülen URL'nin süresi kısa bir süre sonra dolar.

Return

String

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getDescription()

Sayfa öğesinin alternatif metin açıklamasını döndürür. Açıklama, alternatif metni görüntülemek ve okumak için başlıkla birleştirilir.

Return

String: Sayfa öğesinin alternatif metin açıklamasıdır.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getHeight()

Öğenin yüksekliğini noktalar halinde alır. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun yüksekliğidir.

Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin bu yöntemle uyumlu olmadığını öğrenmek için boyutlandırma ve konumlandırma sınırlamalarına bakın.

Return

Number: Sayfa öğesinin noktalar halinde doğal yüksekliği veya sayfa öğesinin yüksekliği yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getInherentHeight()

Öğenin doğal yüksekliğini puan cinsinden döndürür.

Sayfa öğesinin dönüşümü, doğal boyutuna göre değişir. Öğenin nihai görsel görünümünü belirlemek için doğal boyutu öğenin dönüşümüyle birlikte kullanın.

Return

Number: Sayfa öğesinin noktalar halinde doğal yüksekliği veya sayfa öğesinin yüksekliği yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getInherentWidth()

Öğenin doğal genişliğini nokta cinsinden döndürür.

Sayfa öğesinin dönüşümü, doğal boyutuna göre değişir. Öğenin nihai görsel görünümünü belirlemek için doğal boyutu öğenin dönüşümüyle birlikte kullanın.

Return

Number: Sayfa öğesinin noktalar cinsinden doğal genişliği veya sayfa öğesinin genişliği yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getLeft()

Öğe hiç dönmediğinde sayfanın sol üst köşesinden ölçülen, öğenin yatay konumunu noktalar cinsinden döndürür.

Return

Number: Bu öğenin, sayfanın sol üst köşesinden itibaren noktalar halinde yatay konumu.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

Bağlantı yoksa Link veya null değerini döndürür.

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

Return

Link

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getObjectId()

Bu nesnenin benzersiz kimliğini döndürür. Sayfalar ve sayfa öğeleri tarafından kullanılan nesne kimlikleri aynı ad alanını paylaşır.

Return

String: Bu nesnenin benzersiz kimliği.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getPageElementType()

Sayfa öğesinin PageElementType sıralamasıyla belirtilen türünü döndürür.

Return

PageElementType: Sayfa öğesinin türü.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getParentGroup()

Bu sayfa öğesinin ait olduğu grubu veya öğe bir grupta yer almıyorsa null değerini döndürür.

Return

Group: Bu sayfa öğesinin ait olduğu grup veya null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getParentPage()

Bu sayfa öğesinin bulunduğu sayfayı döndürür.

Return

Page: Bu öğenin bulunduğu sayfa.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getParentPlaceholder()

Yer tutucunun üst sayfa öğesini döndürür. Resim bir yer tutucu değilse veya üst öğesi yoksa null değerini döndürür.

Return

PageElement: Bu resim yer tutucusunun üst sayfa öğesi; bu resim bir yer tutucu değilse veya üst öğesi yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getPlaceholderIndex()

Yer tutucu resmin dizinini döndürür. Aynı sayfadaki iki veya daha fazla yer tutucu resim aynı türdeyse her birinin benzersiz dizin değeri olur. Resim bir yer tutucu değilse null değerini döndürür.

Return

Integer — Bu resmin yer tutucu dizini veya resim bir yer tutucu değilse null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getPlaceholderType()

Resmin yer tutucu türünü veya şekil bir yer tutucu değilse PlaceholderType.NONE değerini döndürür.

Return

PlaceholderType: Bu resmin yer tutucu türü.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getRotation()

Öğenin merkezi çevresindeki saat yönünde dönme açısını derece cinsinden döndürür. Sıfır derece, dönüş olmadığı anlamına gelir.

Return

Number: 0 (dahil) ile 360 (hariç) arasında derece cinsinden dönüş açısı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getSourceUrl()

Varsa resmin kaynak URL'sini alır.

URL ile bir resim eklendiğinde, resim ekleme sırasında sağlanan URL'yi döndürür.

Return

String: Resmin URL'si veya resmin kaynak URL'si yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getTitle()

Sayfa öğesinin alternatif metin başlığını döndürür. Başlık, alternatif metni görüntülemek ve okumak için açıklamayla birleştirilir.

Return

String: Sayfa öğesinin alternatif metin başlığı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getTop()

Öğe döndürme olduğunda sayfanın sol üst köşesinden ölçülen, öğenin dikey konumunu noktalar cinsinden alır.

Return

Number: Bu öğenin, sayfanın sol üst köşesinden itibaren noktalar halinde dikey konumu.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getTransform()

Sayfa öğesinin dönüşümünü döndürür.

Sayfa öğesinin görsel görünümü, mutlak dönüşümüyle belirlenir. Mutlak dönüşümü hesaplamak için bir sayfa öğesinin dönüşümünü, tüm üst gruplarındaki dönüşümlerle önceden bağlayın. Sayfa öğesi bir grupta yer almıyorsa mutlak dönüşümü bu alandaki değerle aynıdır.

Return

AffineTransform: Sayfa öğesinin dönüşümü.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getWidth()

Öğenin genişliğini, nokta cinsinden döndürür. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun genişliğidir.

Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin bu yöntemle uyumlu olmadığını öğrenmek için boyutlandırma ve konumlandırma sınırlamalarına bakın.

Return

Number: Sayfa öğesinin noktalar cinsinden doğal genişliği veya sayfa öğesinin genişliği yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

preconcatenateTransform(transform)

Sağlanan dönüşümü, sayfa öğesinin mevcut dönüşümüyle önceden birleştirir.

newTransform = argument * existingTransform

Örneğin, bir sayfa öğesini 36 işaret edecek şekilde sola taşımak için:

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

Ayrıca, sayfa öğesinin dönüşümünü setTransform(transform) ile değiştirebilirsiniz.

Parametreler

AdTürAçıklama
transformAffineTransformBu sayfa öğesinin dönüşümüne önceden bağlanacak dönüşüm.

Return

Image: Zincirleme için bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

remove()

Sayfa öğesini kaldırır.

Bir kaldırma işleminden sonra Group yalnızca bir sayfa öğesi içeriyorsa veya hiç sayfa öğesi içermiyorsa grubun kendisi de kaldırılır.

Bir ana slaytta veya düzende PageElement yer tutucusu kaldırılırsa devralınan boş yer tutucular da kaldırılır.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

Bir Link kaldırır.

shape.removeLink();

replace(blobSource)

Bu resmi, BlobSource nesnesi tarafından açıklanan bir resimle değiştirir.

Eklenen resim bir kez BlobSource üzerinden getirilir ve bir kopyası sunu içinde gösterilmek üzere saklanır. Resimlerin boyutu 50 MB'tan küçük, 25 megapikseli aşmamalı ve PNG, JPEG veya GIF biçiminde olmalıdır.

Resmin en boy oranını korumak için resim mevcut resmin boyutuna göre ölçeklendirilir ve ortalanır.

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

Parametreler

AdTürAçıklama
blobSourceBlobSourceResim verileri.

Return

Image — Bu, değişimden sonra Image.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

replace(blobSource, crop)

Bu resmi, Image nesnesi tarafından açıklanan bir resimle değiştirir ve isteğe bağlı olarak resmi sığacak şekilde kırpar.

Eklenen resim bir kez BlobSource üzerinden getirilir ve bir kopyası sunu içinde gösterilmek üzere saklanır. Resimlerin boyutu 50 MB'tan küçük, 25 megapikseli aşmamalı ve PNG, JPEG veya GIF biçiminde olmalıdır.

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

Parametreler

AdTürAçıklama
blobSourceBlobSourceResim verileri.
cropBooleantrue ise resmi mevcut resmin boyutuna sığacak şekilde kırpar. Aksi takdirde, resim ölçeklendirilir ve ortalanır.

Return

Image — Bu, değişimden sonra Image.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

replace(imageUrl)

Bu resmi, sağlanan URL'den indirilen başka bir resimle değiştirir.

Eklenen resim bir kez URL'den getirilir ve bir kopyası sunuda görüntülenmek üzere saklanır. Resimlerin boyutu 50 MB'tan küçük, 25 megapikseli aşmamalı ve PNG, JPEG veya GIF biçiminde olmalıdır.

Sağlanan URL, herkesin erişimine açık olmalı ve 2 kB'tan büyük olmamalıdır. URL'nin kendisi resimle birlikte kaydedilir ve getSourceUrl() aracılığıyla gösterilir.

Resmin en boy oranını korumak için resim mevcut resmin boyutuna göre ölçeklendirilir ve ortalanır.

Parametreler

AdTürAçıklama
imageUrlStringGörselin indirileceği URL.

Return

Image — Bu, değişimden sonra Image.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

replace(imageUrl, crop)

Bu resmi, sağlanan URL'den indirilen başka bir resimle değiştirir ve isteğe bağlı olarak resmi sığacak şekilde kırpar.

Eklenen resim bir kez URL'den getirilir ve bir kopyası sunuda görüntülenmek üzere saklanır. Resimlerin boyutu 50 MB'tan küçük, 25 megapikseli aşmamalı ve PNG, JPEG veya GIF biçiminde olmalıdır.

Sağlanan URL 2 kB'tan büyük olmamalıdır.

Parametreler

AdTürAçıklama
imageUrlStringGörselin indirileceği URL.
cropBooleantrue ise resmi mevcut resmin boyutuna sığacak şekilde kırpar. Aksi takdirde, resim ölçeklendirilir ve ortalanır.

Return

Image — Bu, değişimden sonra Image.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

scaleHeight(ratio)

Öğenin yüksekliğini belirtilen orana göre ölçeklendirir. Öğenin yüksekliği, öğe döndürme olduğunda sınırlayıcı kutusunun yüksekliğidir.

Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin bu yöntemle uyumlu olmadığını öğrenmek için boyutlandırma ve konumlandırma sınırlamalarına bakın.

Parametreler

AdTürAçıklama
ratioNumberBu sayfa öğesinin yüksekliğini ölçeklendirme oranı.

Return

Image: Zincirleme için bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

scaleWidth(ratio)

Öğenin genişliğini belirtilen orana göre ölçeklendirir. Öğenin genişliği, öğe döndürme olduğunda sınırlayıcı kutusunun genişliğidir.

Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin bu yöntemle uyumlu olmadığını öğrenmek için boyutlandırma ve konumlandırma sınırlamalarına bakın.

Parametreler

AdTürAçıklama
ratioNumberBu sayfa öğesinin genişliğini ölçekleme oranı.

Return

Image: Zincirleme için bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

select()

Etkin sunuda yalnızca PageElement öğesini seçer ve önceki seçimleri kaldırır. Bu, true ile select(replace) numarasını aramak ile aynıdır.

Bir komut dosyası yalnızca komut dosyasını çalıştıran kullanıcının seçimine erişebilir ve komut dosyasının sunuya bağlı olması gerekir.

Bu işlem, PageElement öğesinin üst Page öğesini current page selection olarak ayarlar.

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

select(replace)

Etkin sunuda PageElement öğesini seçer.

Bir komut dosyası yalnızca komut dosyasını çalıştıran kullanıcının seçimine erişebilir ve komut dosyasının sunuya bağlı olması gerekir.

Yalnızca PageElement öğesini seçmek ve önceki seçimleri kaldırmak için bu yönteme true iletin. Bu işlem, PageElement öğesinin üst Page öğesini de current page selection olarak ayarlar.

Birden çok PageElement nesnesi seçmek için false değerini geçirin. PageElement nesneleri aynı Page içinde olmalıdır.

false parametresi kullanılarak sayfa öğesi seçilirken aşağıdaki koşullar karşılanmalıdır:

  1. PageElement nesnesinin üst Page öğesi current page selection olmalıdır.
  2. Birden fazla Page nesnesi seçilmemelidir.

Bu durumun söz konusu olduğundan emin olmak için tercih edilen yaklaşım, önce Page.selectAsCurrentPage() kullanarak üst Page öğesini, ardından bu sayfadaki sayfa öğelerini seçmektir.

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);
}

Parametreler

AdTürAçıklama
replaceBooleantrue ise önceki seçimlerin yerini alır; aksi takdirde önceki seçimlere eklenir.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

sendBackward()

Sayfa öğesini bir öğe tarafından sayfada geriye doğru gönderir.

Sayfa öğesi bir grupta olmamalıdır.

Return

Image: Zincirleme için bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

sendToBack()

Sayfa öğesini sayfanın arkasına gönderir.

Sayfa öğesi bir grupta olmamalıdır.

Return

Image: Zincirleme için bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

setDescription(description)

Sayfa öğesinin alternatif metin açıklamasını ayarlar.

Yöntem, Group öğeleri için desteklenmiyor.

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

Parametreler

AdTürAçıklama
descriptionStringAlternatif metin açıklamasının ayarlanacağı dize.

Return

Image — Bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

setHeight(height)

Öğenin yüksekliğini noktalar halinde ayarlar. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun yüksekliğidir.

Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin bu yöntemle uyumlu olmadığını öğrenmek için boyutlandırma ve konumlandırma sınırlamalarına bakın.

Parametreler

AdTürAçıklama
heightNumberBu sayfa öğesinin nokta cinsinden ayarlanacak yeni yüksekliği.

Return

Image: Zincirleme için bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

setLeft(left)

Öğenin yatay konumunu, öğe döndürme olduğunda sayfanın sol üst köşesinden ölçülen noktalar cinsinden ayarlar.

Parametreler

AdTürAçıklama
leftNumberNokta cinsinden ayarlanacak yeni yatay konum.

Return

Image: Zincirleme için bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

setLinkSlide(slideIndex)

Slaytın sıfır tabanlı dizinini kullanarak bir Link öğesini belirtilen Slide olarak ayarlar.

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

Parametreler

AdTürAçıklama
slideIndexIntegerSlaytın sıfır tabanlı dizini.

Return

Link — ayarlanan Link

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

setLinkSlide(slide)

Link öğesini belirtilen Slide değerine ayarlarsa bağlantı, belirtilen slayt kimliğine göre ayarlanır.

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

Parametreler

AdTürAçıklama
slideSlideBağlanacak Slide.

Return

Link — ayarlanan Link

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

setLinkSlide(slidePosition)

Slaytın göreli konumunu kullanarak belirli bir Slide için Link ayarlar.

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

Parametreler

AdTürAçıklama
slidePositionSlidePositionGöreli SlidePosition.

Return

Link — ayarlanan Link

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

setLinkUrl(url)

Belirli boş olmayan URL dizesine Link ayarlar.

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

Parametreler

AdTürAçıklama
urlStringURL dizesi.

Return

Link — ayarlanan Link

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

setRotation(angle)

Öğenin merkezi etrafında saat yönünde dönme açısını derece cinsinden ayarlar.

Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin bu yöntemle uyumlu olmadığını öğrenmek için boyutlandırma ve konumlandırma sınırlamalarına bakın.

Parametreler

AdTürAçıklama
angleNumberDerece cinsinden ayarlanacak yeni saat yönünde dönme açısı.

Return

Image: Zincirleme için bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

setTitle(title)

Sayfa öğesinin alternatif metin başlığını ayarlar.

Yöntem, Group öğeleri için desteklenmiyor.

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

Parametreler

AdTürAçıklama
titleStringAlternatif metin başlığının ayarlanacağı dize.

Return

Image — Bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

setTop(top)

Öğe döndürme olduğunda, sayfanın sol üst köşesinden ölçülen, öğenin dikey konumunu noktalar cinsinden ayarlar.

Parametreler

AdTürAçıklama
topNumberNokta cinsinden ayarlanacak yeni dikey konum.

Return

Image: Zincirleme için bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

setTransform(transform)

Sağlanan dönüşümle sayfa öğesinin dönüşümünü ayarlar.

Bir grubun dönüşümünün güncellenmesi, söz konusu gruptaki sayfa öğelerinin mutlak dönüşümünü değiştirir ve bu da görsel görünümlerini değiştirebilir.

Bir gruptaki sayfa öğesinin dönüşümünü güncellemek yalnızca söz konusu sayfa öğesinin dönüşümünü değiştirir. Grubun veya gruptaki diğer sayfa öğelerinin dönüşümlerini etkilemez.

Dönüşümlerin, sayfa öğelerinin görsel görünümünü nasıl etkilediğiyle ilgili ayrıntılar için getTransform() bölümüne bakın.

Parametreler

AdTürAçıklama
transformAffineTransformBu sayfa öğesi için ayarlanan dönüşüm.

Return

Image: Zincirleme için bu öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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

setWidth(width)

Öğenin genişliğini, noktalar halinde ayarlar. Bu, öğe döndürme olmadığında öğenin sınırlayıcı kutusunun genişliğidir.

Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin bu yöntemle uyumlu olmadığını öğrenmek için boyutlandırma ve konumlandırma sınırlamalarına bakın.

Parametreler

AdTürAçıklama
widthNumberBu sayfa öğesinin nokta cinsinden ayarlanacak yeni genişliği.

Return

Image: Zincirleme için bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:

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