Class Image

Resim

Bir resmi temsil eden PageElement.

Yöntemler

YöntemDönüş türüKısa açıklama
alignOnPage(alignmentPosition)ImageÖğeyi sayfadaki belirtilen hizalama konumuna getirir.
bringForward()ImageSayfa öğesini bir öğe ileri getirir.
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ürme.
getBlob()BlobBu resmin içindeki verileri bir blob olarak döndürme.
getBorder()BorderResmin Border değerini döndürür.
getConnectionSites()ConnectionSite[]Sayfa öğesindeki ConnectionSite öğelerinin listesini veya sayfa öğesinde bağlantı sitesi yoksa boş bir listeyi 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 cinsinden alır. Bu değer, öğe döndürülmediğinde öğenin sınırlayıcı kutusunun yüksekliğidir.
getInherentHeight()NumberÖğenin doğal yüksekliğini noktalar cinsinden döndürür.
getInherentWidth()NumberÖğenin doğal genişliğini noktalar cinsinden döndürür.
getLeft()NumberÖğenin yatay konumunu, öğe döndürülmemişken sayfanın sol üst köşesinden ölçülen 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 türünü PageElementType enum olarak döndürür.
getParentGroup()GroupBu 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()PageElementYer tutucunun üst sayfa öğesini döndürür.
getPlaceholderIndex()IntegerYer tutucu resmin dizin numarasını döndürür.
getPlaceholderType()PlaceholderTypeResmin yer tutucu türünü döndürür veya şekil bir yer tutucu değilse PlaceholderType.NONE değerini döndürür.
getRotation()NumberÖğenin merkezi etrafında saat yönünde dönme açısını derece cinsinden döndürür. Sıfır derece, dönme 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Öğenin dikey konumunu, öğede rotasyon olmadığında sayfanın sol üst köşesinden ölçülen noktalar cinsinden alır.
getTransform()AffineTransformSayfa öğesinin dönüştürme işlemini döndürür.
getWidth()NumberÖğenin genişliğini nokta cinsinden döndürür. Bu değer, öğe döndürülmediğinde öğenin sınırlayıcı kutusunun genişliğidir.
preconcatenateTransform(transform)ImageSağlanan dönüştürme işlemini, sayfa öğesinin mevcut dönüştürme işlemiyle önceden birleştirir.
remove()voidSayfa öğesini kaldırır.
removeLink()voidBir Link kaldırılır.
replace(blobSource)ImageBu resmi, BlobSource nesnesi tarafından tanımlanan bir resimle değiştirir.
replace(blobSource, crop)ImageBu resmi, isteğe bağlı olarak sığacak şekilde kırparak Image nesnesi tarafından tanımlanan bir resimle değiştirir.
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ığdıracak şekilde kırpar.
scaleHeight(ratio)ImageÖğenin yüksekliğini belirtilen orana göre ölçekler.
scaleWidth(ratio)ImageÖğenin genişliğini belirtilen orana göre ölçekler.
select()voidEtkin sunudaki yalnızca PageElement seçeneğini belirler ve önceki tüm seçimleri kaldırır.
select(replace)voidEtkin sunudaki PageElement'ü seçer.
sendBackward()ImageSayfa öğesini 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 nokta cinsinden ayarlar. Bu değer, öğ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ülmemişken sayfanın sol üst köşesinden ölçülen noktalar cinsinden ayarlar.
setLinkSlide(slideIndex)LinkSlaytın sıfır tabanlı dizini kullanılarak belirli bir Slide için Link ayarlanır.
setLinkSlide(slide)LinkBelirli bir Link için Slide ayarlanır. Bağlantı, belirtilen slayt kimliğine göre ayarlanır.
setLinkSlide(slidePosition)LinkSlaytın göreli konumunu kullanarak Link öğesini belirli bir Slide öğesine ayarlar.
setLinkUrl(url)LinkBelirtilen boş olmayan URL dizesine bir Link ayarlar.
setRotation(angle)ImageÖğenin merkezi etrafında saat yönünde dönme açısını derece cinsinden belirler.
setTitle(title)ImageSayfa öğesinin alternatif metin başlığını ayarlar.
setTop(top)ImageÖğenin dikey konumunu, öğe döndürülmediğinde sayfanın sol üst köşesinden ölçülen noktalar cinsinden ayarlar.
setTransform(transform)ImageSayfa öğesinin dönüştürme işlemini, sağlanan dönüştürme işlemiyle ayarlar.
setWidth(width)ImageÖğenin genişliğini nokta cinsinden ayarlar. Bu değer, öğe döndürülmediğinde öğenin sınırlayıcı kutusunun genişliğidir.

Ayrıntılı dokümanlar

alignOnPage(alignmentPosition)

Öğeyi sayfadaki belirtilen hizalama konumuna getirir.

Parametreler

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

Return

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

bringForward()

Sayfa öğesini bir öğe ileri getirir.

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

duplicate()

Sayfa öğesini kopyalar.

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

Return

PageElement: Bu sayfa öğesinin yeni kopyası.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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ürme. Bu yöntem, dosya adına uygun uzantıyı ekler (ör. "dosyam.pdf"). Ancak, dosya adının son noktayı (varsa) izleyen kısmının, değiştirilmesi gereken mevcut bir uzantı olduğu varsayılır. Sonuç olarak, "AlışverişListesi.25.12.2014", "AlışverişListesi.25.12.pdf" olur.

Dönüşümler için günlük kotaları görüntülemek istiyorsanız Google Hizmetleri için 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 'application/pdf' tek geçerli seçenektir. BMP, GIF, JPEG veya PNG biçimindeki resimler için 'image/bmp', 'image/gif', 'image/jpeg' veya 'image/png' değerlerinden herhangi biri de geçerlidir. Google Dokümanlar dokümanı için 'text/markdown' de geçerlidir.

Return

Blob: Veriler bir blob olarak.

getBlob()

Bu resimdeki verileri bir blob olarak döndürür.

Return

Blob: Resim verileri, blob olarak.

getBorder()

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

Return

Border: Resmin kenarı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getConnectionSites()

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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 etiketlendiğinden, URL'ye sahip olan herkes resme orijinal istek sahibi olarak erişebilir. 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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ı.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getHeight()

Öğenin yüksekliğini noktalar 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: Sayfa öğesinin nokta cinsinden doğal yüksekliği veya sayfa öğesinin yüksekliği yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getInherentHeight()

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

Sayfa öğesinin dönüşümü, kendi boyutuna göredir. Öğenin nihai görsel görünümünü belirlemek için öğenin dönüştürme özelliğiyle birlikte doğal boyutu kullanın.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getInherentWidth()

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

Sayfa öğesinin dönüşümü, kendi boyutuna göredir. Öğenin nihai görsel görünümünü belirlemek için öğenin dönüştürme özelliğiyle birlikte doğal boyutu kullanın.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getLeft()

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

Return

Number: Bu öğenin, sayfanın sol üst köşesine göre yatay konumu (noktalar cinsinden).

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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: Bağlantı yoksa Link veya null.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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: Bu sayfa öğesinin ait olduğu grup veya null.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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 döndürür.

Return

PageElement: 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getPlaceholderIndex()

Yer tutucu resmin dizin numarasını döndürür. Aynı sayfada iki veya daha fazla yer tutucu resim aynı türdeyse her birinin benzersiz bir dizine ekleme değeri vardır. Resim bir yer tutucu değilse null 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getPlaceholderType()

Resmin yer tutucu türünü döndürür 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getRotation()

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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: Resmin URL'si veya resmin kaynak URL'si yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getTop()

Öğenin dikey konumunu, öğede rotasyon olmadığında sayfanın sol üst köşesinden ölçülen noktalar cinsinden alır.

Return

Number: Bu öğenin, sayfanın sol üst köşesine göre nokta cinsinden dikey konumu.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getTransform()

Sayfa öğesinin dönüştürme işlemini döndürür.

Sayfa öğesinin görsel görünümü, mutlak dönüşümüne göre 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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 değer, öğ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: Sayfa öğesinin nokta cinsinden doğal genişliği veya sayfa öğesinin genişliği yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

preconcatenateTransform(transform)

Sağlanan dönüştürme işlemini, sayfa öğesinin mevcut dönüştürme işlemiyle önceden birleştirir. 

newTransform = argument * existingTransform;

Örneğin, bir sayfa öğesini 36 nokta 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üştürme özelliğini setTransform(transform) ile de değiştirebilirsiniz.

Parametreler

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

remove()

Sayfa öğesini kaldırır.

Kaldırma işleminin ardından bir Group yalnızca bir sayfa öğesi 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 devralan boş yer tutucular da kaldırılır.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

Bir Link kaldırılır. 

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

replace(blobSource)

Bu resmi, BlobSource nesnesi tarafından tanımlanan bir resimle değiştirir.

Resim eklendiğinde BlobSource kaynağından bir kez alınır ve sunu içinde gösterilmek üzere bir kopyası saklanır. Resimler 50 MB'tan küçük, 25 megapikselden büyük olmamalı 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 ortalanmalıdı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: Değişimden sonraki Image.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

replace(blobSource, crop)

Bu resmi, isteğe bağlı olarak sığacak şekilde kırparak Image nesnesi tarafından tanımlanan bir resimle değiştirir.

Resim eklendiğinde BlobSource kaynağından bir kez alınır ve sunu içinde gösterilmek üzere bir kopyası saklanır. Resimler 50 MB'tan küçük, 25 megapikselden büyük olmamalı 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: Değişimden sonra bu Image.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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 eklendiğinde URL'den bir kez alınır ve sunumda gösterilmek üzere bir kopyası depolanır. Resimler 50 MB'tan küçük, 25 megapikselden büyük olmamalı ve PNG, JPEG veya GIF biçiminde olmalıdır.

Sağlanan URL herkese açık olmalı ve 2 KB'tan büyük olmamalıdır. URL, 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: Değişimden sonra bu Image.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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ığdıracak şekilde kırpar.

Resim eklendiğinde URL'den bir kez alınır ve sunumda gösterilmek üzere bir kopyası depolanır. Resimler 50 MB'tan küçük, 25 megapikselden büyük olmamalı ve PNG, JPEG veya GIF biçiminde olmalıdır.

Sağlanan URL en fazla 2 KB olmalı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: Değişimden sonra bu Image.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

scaleHeight(ratio)

Öğenin yüksekliğini belirtilen orana göre ölçekler. Öğenin yüksekliği, öğe döndürülmemişken 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ğinin ölçeklendirileceği oran.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

scaleWidth(ratio)

Öğenin genişliğini belirtilen orana göre ölçekler. Öğenin genişliği, öğe döndürülmemişken 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 bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

select()

Etkin sunudaki yalnızca PageElement seçeneğini belirler ve önceki tüm seçimleri kaldırır. Bu, select(replace) işlevini true ile çağırmaya eşdeğerdir.

Bir komut dosyası, yalnızca komut dosyasını çalıştıran kullanıcının seçimine erişebilir ve bu da komut dosyası sunucuya bağlıysa geçerlidir.

Bu işlem, PageElement öğesinin üst öğesi Page'ü 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

select(replace)

Etkin sunudaki PageElement'ü seçer.

Bir komut dosyası, yalnızca komut dosyasını çalıştıran kullanıcının seçimine erişebilir ve bu da komut dosyası sunucuya bağlıysa geçerlidir.

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

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

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

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

Bu durumdan emin olmak için tercih edilen yaklaşım, önce Page.selectAsCurrentPage() kullanarak üst öğeyi Page seçip 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 seçimin yerini alır. Aksi takdirde seçim önceki seçime eklenir.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

sendBackward()

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

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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 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ın ayarlanacağı dize.

Return

Image: Bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setHeight(height)

Öğenin yüksekliğini nokta cinsinden ayarlar. 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.

Parametreler

AdTürAçıklama
heightNumberAyarlanacak bu sayfa öğesinin yeni yüksekliği (noktada).

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setLeft(left)

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

Parametreler

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setLinkSlide(slideIndex)

Slaytın sıfır tabanlı dizini kullanılarak belirli bir Slide için Link 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(0);

Parametreler

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

Return

Link: Ayarlanan Link.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setLinkSlide(slide)

Belirtilen Link için bir Slide ayarlar. Bağlantı, belirtilen 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setLinkSlide(slidePosition)

Slaytın göreli konumunu kullanarak Link öğesini belirli bir Slide öğesine 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öreli SlidePosition.

Return

Link: Ayarlanan Link.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setLinkUrl(url)

Belirtilen boş olmayan URL dizesine bir Link 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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 belirler.

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 bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

  • 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 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ılacak dize.

Return

Image: Bu sayfa öğesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setTop(top)

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

Parametreler

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setTransform(transform)

Sayfa öğesinin dönüştürme işlemini, sağlanan dönüştürme işlemiyle ayarlar.

Bir grubun dönüştürme işleminin güncellenmesi, söz konusu gruptaki sayfa öğelerinin mutlak dönüştürme işlemini değiştirir. Bu da öğelerin görsel görünümünü değiştirebilir.

Bir gruptaki sayfa öğesinin dönüştürme işlemini güncellemek yalnızca ilgili sayfa öğesinin dönüştürme işlemini değiştirir. Grubun veya gruptaki diğer sayfa öğelerinin dönüştürme işlemlerini etkilemez.

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

Parametreler

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

Return

Image: Zincirleme için bu öğe.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

setWidth(width)

Öğenin genişliğini nokta cinsinden ayarlar. Bu değer, öğ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
widthNumberAyarlanacak bu sayfa öğesinin yeni genişliği (punto cinsinden).

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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