Class Image

Resim

Resmi temsil eden bir 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 ileri taşır.
bringToFront()ImageSayfa öğesini sayfanın önüne getirir.
duplicate()PageElementSayfa öğesini kopyalar.
getAs(contentType)BlobBu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürür.
getBlob()BlobBu resimdeki verileri blob olarak döndür.
getBorder()BorderResmin Border değerini döndürür.
getConnectionSites()ConnectionSite[]Sayfa öğesindeki ConnectionSite listesini veya sayfa öğesinde 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|nullÖğenin yüksekliğini puan cinsinden alır. Bu değer, öğe döndürülmediğinde öğenin sınırlayıcı kutusunun yüksekliğidir.
getInherentHeight()Number|nullÖğenin doğal yüksekliğini puan cinsinden döndürür.
getInherentWidth()Number|nullÖğenin doğal genişliğini puan cinsinden döndürür.
getLeft()NumberÖğe döndürülmediğinde sayfanın sol üst köşesinden ölçülen, öğenin yatay konumunu puan cinsinden döndürür.
getLink()Link|nullBağlantı yoksa Link veya null değerini döndürür.
getObjectId()StringBu nesnenin benzersiz kimliğini döndürür.
getPageElementType()PageElementTypeSayfa öğesinin türünü PageElementType enum olarak döndürür.
getParentGroup()Group|nullBu sayfa öğesinin ait olduğu grubu veya öğe bir grupta değilse null değerini döndürür.
getParentPage()PageBu sayfa öğesinin bulunduğu sayfayı döndürür.
getParentPlaceholder()PageElement|nullYer tutucunun üst sayfa öğesini döndürür.
getPlaceholderIndex()Integer|nullYer tutucu resmin dizinini döndürür.
getPlaceholderType()PlaceholderTypeResmin yer tutucu türünü veya şekil yer tutucu değilse PlaceholderType.NONE değerini döndürür.
getRotation()NumberÖğenin merkezi etrafındaki saat yönünde dönüş açısını derece cinsinden döndürür. Sıfır derece, dönüş olmadığı anlamına gelir.
getSourceUrl()String|nullVarsa resmin kaynak URL'sini alır.
getTitle()StringSayfa öğesinin alternatif metin başlığını döndürür.
getTop()NumberÖğe döndürülmediğinde, sayfanın sol üst köşesinden itibaren ölçülen, öğenin dikey konumunu puan cinsinden alır.
getTransform()AffineTransformSayfa öğesinin dönüşümünü döndürür.
getWidth()Number|nullÖğenin genişliğini puan cinsinden döndürür. Bu, öğe döndürülmediğinde öğ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()voidLink öğesini kaldırır.
replace(blobSource)ImageBu resmi, BlobSource nesnesiyle açıklanan bir resimle değiştirir.
replace(blobSource, crop)ImageBu resmi, Image nesnesiyle açıklanan bir resimle değiştirir. İsteğ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. İsteğe bağlı olarak resmi sığacak şekilde kırpar.
scaleHeight(ratio)ImageÖğenin yüksekliğini belirtilen oranda ölçeklendirir.
scaleWidth(ratio)ImageÖğenin genişliğini belirtilen oranda ölçeklendirir.
select()voidYalnızca etkin sunudaki PageElement öğesini seçer ve önceki seçimleri kaldırır.
select(replace)voidEtkin sunudaki PageElement öğesini seçer.
sendBackward()ImageSayfa öğesini sayfada bir öğe geriye 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 puan cinsinden ayarlar. Bu, öğe döndürülmediğinde öğenin sınırlayıcı kutusunun yüksekliğidir.
setLeft(left)ImageÖğenin yatay konumunu, öğe döndürülmediğinde sayfanın sol üst köşesinden itibaren ölçülen puanlar cinsinden ayarlar.
setLinkSlide(slideIndex)LinkSlaytın sıfır tabanlı dizinini kullanarak belirtilen Slide değerine Link ayarlar.
setLinkSlide(slide)LinkBelirtilen Link değerini, verilen Slide olarak ayarlar. Bağlantı, verilen slayt kimliğine göre ayarlanır.
setLinkSlide(slidePosition)LinkSlaydın göreli konumunu kullanarak belirtilen Slide için Link ayarlar.
setLinkUrl(url)LinkLink özelliğini, verilen boş olmayan URL dizesine ayarlar.
setRotation(angle)ImageÖğenin merkezi etrafındaki saat yönünde dönüş açısını derece cinsinden ayarlar.
setTitle(title)ImageSayfa öğesinin alternatif metin başlığını ayarlar.
setTop(top)ImageÖğe döndürülmediğinde, öğenin dikey konumunu sayfanın sol üst köşesinden itibaren ölçülen puanlar cinsinden ayarlar.
setTransform(transform)ImageSayfa öğesinin dönüşümünü, sağlanan dönüşümle ayarlar.
setWidth(width)ImageÖğenin genişliğini puan cinsinden ayarlar. Bu, öğe döndürülmediğinde öğ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 kullanılan bu sayfa öğesi.

bringForward()

Sayfa öğesini sayfada bir öğe ileri taşır.

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 kullanılan bu sayfa öğesi.

Yetkilendirme

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

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

duplicate()

Sayfa öğesini kopyalar.

Kopya sayfa öğesi, orijinaliyle aynı sayfaya aynı konumda yerleştirilir.

Return

PageElement: Bu sayfa öğesinin yeni kopyası.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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ür. Bu yöntem, dosya adına uygun uzantıyı ekler (ör. "dosyam.pdf"). Ancak, dosya adının son noktadan sonraki kısmının (varsa) değiştirilmesi gereken mevcut bir uzantı olduğunu varsayar. Bu nedenle, "ShoppingList.12.25.2014" ifadesi "ShoppingList.12.25.pdf" olur.

Dönüşümlerle ilgili günlük kotaları görüntülemek için Google Hizmetleri Kotaları başlıklı makaleyi inceleyin. Yeni oluşturulan Google Workspace alanları geçici olarak daha katı kotalara tabi olabilir.

Parametreler

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

Return

Blob — Veriler blob olarak.

getBlob()

Bu resimdeki verileri blob olarak döndür.

Return

Blob: Blob olarak görüntü verileri.

getBorder()

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

Return

Border: Resmin kenarlığı.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 öğesinde bağlantı sitesi yoksa boş bir liste döndürür.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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, istekte bulunanın hesabıyla etiketlenir. Bu nedenle, URL'ye sahip olan herkes, resme istekte bulunan kişi olarak erişir. Sununun paylaşım ayarları değişirse resme erişim kaybedilebilir. Döndürülen URL'nin geçerliliği kısa bir süre sonra sona erer.

Return

String

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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östermek ve okumak için başlıkla birlikte kullanılır.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 puan cinsinden alır. Bu değer, öğe döndürülmediğinde öğ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ı bölümüne bakın.

Return

Number|null: Sayfa öğesinin puan cinsinden doğal yüksekliği veya sayfa öğesinin yüksekliği yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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ü, kendi boyutuna göre belirlenir. Öğenin nihai görsel görünümünü belirlemek için öğenin dönüşümüyle birlikte doğal boyutu kullanın.

Return

Number|null: Sayfa öğesinin puan cinsinden doğal yüksekliği veya sayfa öğesinin yüksekliği yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 puan cinsinden döndürür.

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

Return

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

Yetkilendirme

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

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

getLeft()

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

Return

Number: Bu öğenin, sayfanın sol üst köşesinden itibaren yatay konumu (nokta cinsinden).

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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. 

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

Return

Link|null: Bağlantı yoksa Link veya null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getPageElementType()

Sayfa öğesinin türünü PageElementType enum olarak döndürür.

Return

PageElementType: Sayfa öğesinin türü.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 değilse null değerini döndürür.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 kapsamlardan 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 yer tutucu değilse veya üst öğesi yoksa null değerini döndürür.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 bir dizin değeri vardır. Resim yer tutucu değilse null değerini döndürür.

Return

Integer|null: Bu resmin yer tutucu dizini veya resim yer tutucu değilse null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 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 kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

getRotation()

Öğenin merkezi etrafındaki saat yönünde dönüş 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 kapsamlardan 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.

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

Return

String|null: Resim URL'si veya resmin kaynak URL'si yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 birlikte kullanılır.

Return

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

Yetkilendirme

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

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

getTop()

Öğe döndürülmediğinde, sayfanın sol üst köşesinden itibaren ölçülen, öğenin dikey konumunu puan cinsinden alır.

Return

Number: Bu öğenin, sayfanın sol üst köşesinden itibaren dikey konumu (nokta cinsinden).

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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ının dönüşümleriyle önceden birleştirin. Sayfa öğesi bir grupta değilse 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 kapsamlardan 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 puan cinsinden döndürür. Bu, öğe döndürülmediğinde öğ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ı bölümüne bakın.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 puan sola taşımak için: 

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

Sayfa öğesinin dönüşümünü setTransform(transform) ile de değiştirebilirsiniz.

Parametreler

AdTürAçıklama
transformAffineTransformBu sayfa öğesinin dönüştürmesine önceden birleştirilecek dönüştürme.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 veya hiç sayfa öğesi içermiyorsa grubun kendisi de kaldırılır.

Bir ana öğede veya düzende yer tutucu PageElement kaldırılırsa devralınan tüm boş yer tutucular da kaldırılır.

Yetkilendirme

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

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

Link öğesini kaldırır. 

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

replace(blobSource)

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

Görüntü eklenirken BlobSource kaynağından bir kez alınır ve sunuda gösterilmek üzere bir kopyası saklanır. Görsellerin boyutu 50 MB'tan küçük olmalı, 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. 

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

Parametreler

AdTürAçıklama
blobSourceBlobSourceResim verileri.

Return

Image — Bu, Image değiştirildikten sonraki durumdur.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 nesnesiyle açıklanan bir resimle değiştirir. İsteğe bağlı olarak resmi sığacak şekilde kırpar.

Görüntü eklenirken BlobSource kaynağından bir kez alınır ve sunuda gösterilmek üzere bir kopyası saklanır. Görsellerin boyutu 50 MB'tan küçük olmalı, 25 megapikseli aşmamalı ve PNG, JPEG veya GIF biçiminde olmalıdır. 

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

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, Image değiştirildikten sonraki durumdur.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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.

Resim eklediğinizde URL'den bir kez alınır ve sunuda gösterilmek üzere bir kopyası saklanır. Resimler 50 MB'tan küçük olmalı, 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() üzerinden 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
imageUrlStringResmin indirileceği URL.

Return

Image — Bu, Image değiştirildikten sonraki durumdur.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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. İsteğe bağlı olarak resmi sığacak şekilde kırpar.

Resim eklediğinizde URL'den bir kez alınır ve sunuda gösterilmek üzere bir kopyası saklanır. Resimler 50 MB'tan küçük olmalı, 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
imageUrlStringResmin 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, Image değiştirildikten sonraki durumdur.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 oranda ölçeklendirir. Öğenin yüksekliği, öğe döndürülmediğinde 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ı bölümüne bakın.

Parametreler

AdTürAçıklama
ratioNumberBu sayfa öğesinin yüksekliğini ölçeklendirmek için kullanılan oran.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 oranda ölçeklendirir. Öğenin genişliği, öğe döndürülmediğinde 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ı bölümüne bakın.

Parametreler

AdTürAçıklama
ratioNumberBu sayfa öğesinin genişliğinin ölçekleneceği oran.

Return

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

Yetkilendirme

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

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

select()

Yalnızca etkin sunudaki PageElement öğesini seçer ve önceki seçimleri kaldırır. Bu, select(replace) işlevini true ile çağırmakla aynıdır.

Bir komut dosyası yalnızca komut dosyasını çalıştıran kullanıcının seçimine erişebilir ve yalnızca komut dosyası sunuya bağlıysa bu işlemi yapabilir.

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

const slide = SlidesApp.getActivePresentation().getSlides()[0];
const 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 kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

select(replace)

Etkin sunudaki PageElement öğesini seçer.

Bir komut dosyası yalnızca komut dosyasını çalıştıran kullanıcının seçimine erişebilir ve yalnızca komut dosyası sunuya bağlıysa bu işlemi yapabilir.

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

Birden fazla PageElement nesne seçmek için geçirin.false PageElement nesneleri aynı Page içinde olmalıdır.

false parametresi kullanılarak bir sayfa öğesi seçilirken aşağıdaki koşulların karşılanması gerekir:

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

Bunun böyle olduğundan emin olmak için tercih edilen yaklaşım, önce Page.selectAsCurrentPage() kullanarak üst öğeyi Page seçmek, ardından bu sayfadaki sayfa öğelerini seçmektir. 

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

Parametreler

AdTürAçıklama
replaceBooleantrue ise seçim, önceki tüm seçimlerin yerini alır. Aksi takdirde seçim, önceki tüm seçimlere eklenir.

Yetkilendirme

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

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

sendBackward()

Sayfa öğesini sayfada bir öğe geriye gönderir.

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 kullanılan bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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.

Bu yöntem, Group öğeleri için desteklenmez. 

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

Parametreler

AdTürAçıklama
descriptionStringAlternatif metin açıklamasını ayarlamak için kullanılan dize.

Return

Image: Bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 puan cinsinden ayarlar. Bu, öğe döndürülmediğinde öğ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ı bölümüne bakın.

Parametreler

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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ürülmediğinde sayfanın sol üst köşesinden itibaren ölçülen puanlar cinsinden ayarlar.

Parametreler

AdTürAçıklama
leftNumberAyarlanacak yeni yatay konum (nokta cinsinden).

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 belirtilen Slide değerine Link ayarlar. 

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

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 kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

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

setLinkSlide(slide)

Belirtilen Link değerini, verilen Slide olarak ayarlar. Bağlantı, verilen slayt kimliğine göre ayarlanır. 

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

Parametreler

AdTürAçıklama
slideSlideBağlanacak Slide.

Return

Link: Ayarlanan Link.

Yetkilendirme

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

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

setLinkSlide(slidePosition)

Slaydın göreli konumunu kullanarak belirtilen Slide için Link ayarlar. 

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

Parametreler

AdTürAçıklama
slidePositionSlidePositionGöreceli SlidePosition.

Return

Link: Ayarlanan Link.

Yetkilendirme

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

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

setLinkUrl(url)

Link özelliğini, verilen boş olmayan URL dizesine ayarlar. 

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

Parametreler

AdTürAçıklama
urlStringURL dizesi.

Return

Link: Ayarlanan Link.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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ındaki saat yönünde dönüş 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ı bölümüne bakın.

Parametreler

AdTürAçıklama
angleNumberAyarlanacak yeni saat yönünde dönüş açısı (derece cinsinden).

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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.

Bu yöntem, Group öğeleri için desteklenmez. 

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

Parametreler

AdTürAçıklama
titleStringAlternatif metin başlığını ayarlamak için kullanılan dize.

Return

Image: Bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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ürülmediğinde, öğenin dikey konumunu sayfanın sol üst köşesinden itibaren ölçülen puanlar cinsinden ayarlar.

Parametreler

AdTürAçıklama
topNumberAyarlanacak yeni dikey konum (puan cinsinden).

Return

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

Yetkilendirme

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

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

setTransform(transform)

Sayfa öğesinin dönüşümünü, sağlanan dönüşümle ayarlar.

Bir grubun dönüşümünü güncellemek, o gruptaki sayfa öğelerinin mutlak dönüşümünü değiştirir. Bu da öğelerin görsel görünümünü değiştirebilir.

Bir grupta bulunan bir 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() başlıklı makaleyi inceleyin.

Parametreler

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

Return

Image: Bu öğe, zincirleme için kullanılır.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 puan cinsinden ayarlar. Bu, öğe döndürülmediğinde öğ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ı bölümüne bakın.

Parametreler

AdTürAçıklama
widthNumberBu sayfa öğesinin yeni genişliği (punto cinsinden).

Return

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

Yetkilendirme

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

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