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 bir öğe ilerletir.
bringToFront()ImageSayfa öğesini sayfanın ön tarafına 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ün.
getBlob()BlobBu görüntünün içindeki verileri blob olarak döndürün.
getBorder()BorderResmin Border değerini döndürür.
getConnectionSites()ConnectionSite[]Sayfa öğesindeki ConnectionSite listesini veya sayfaysa boş bir listeyi döndürür öğesinin herhangi bir bağlantı sitesi yok.
getContentUrl()StringResmin URL'sini alır.
getDescription()StringSayfa öğesinin alternatif metin açıklamasını döndürür.
getHeight()NumberÖğenin, nokta cinsinden yüksekliğini alır. Bu, öğesinin rotasyonu yok.
getInherentHeight()NumberÖğenin doğal yüksekliğini punto cinsinden döndürür.
getInherentWidth()NumberÖğenin doğal genişliğini punto olarak döndürür.
getLeft()NumberÖğenin, öğenin sol üst köşesinden ölçülen, noktalardaki yatay konumunu döndürür sayfa için bir değer girin.
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ı ile temsil edilen türünü döndürür.
getParentGroup()GroupBu sayfa öğesinin ait olduğu grubu veya öğe birnull grubu.
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 değilse PlaceholderType.NONE değerini döndürür yer tutucudur.
getRotation()NumberÖğenin, merkezi etrafında saat yönünde dönüş açısını derece cinsinden döndürür (sıfır derece) rotasyon olmadığı anlamına gelir.
getSourceUrl()StringGörselin kaynak URL'sini (varsa) alır.
getTitle()StringSayfa öğesinin alternatif metin başlığını döndürür.
getTop()NumberÖğenin, sayfanın sol üst köşesinden ölçülen noktalardaki dikey konumunu alır öğe döndürülmediğinde.
getTransform()AffineTransformSayfa öğesinin dönüşümünü döndürür.
getWidth()NumberNokta cinsinden öğenin genişliğini döndürür. Bu, söz konusu olduğunda öğenin sınırlayıcı kutusunun genişliğidir öğede rotasyon yok.
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 kaldırılır.
replace(blobSource)ImageBu resmi, BlobSource nesnesiyle açıklanan resimle değiştirir.
replace(blobSource, crop)ImageBu resmi, bir Image nesnesi tarafından açıklanan resimle değiştirir (isteğe bağlı olarak kırpılır) resmi sığdırır.
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 (isteğe bağlı olarak kırpılır) resmi sığdırır.
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 daha öncekileri kaldırır seçim.
select(replace)voidEtkin sunudaki PageElement öğesini seçer.
sendBackward()ImageSayfa öğesini bir öğe geri gönderir.
sendToBack()ImageSayfa öğesini sayfanın arkasına gönderir.
setDescription(description)ImageSayfa öğesinin alternatif metin açıklamasını ayarlar.
setHeight(height)ImageNokta cinsinden öğenin yüksekliğini ayarlar. Bu, öğesinin rotasyonu yok.
setLeft(left)ImageNoktalarda öğenin yatay konumunu ayarlar. Konum, grafiğin sol üst köşesinden sayfa için bir değer girin.
setLinkSlide(slideIndex)LinkSlaytın sıfır tabanlı dizinini kullanarak belirtilen Slide için bir Link ayarlar.
setLinkSlide(slide)LinkBelirtilen Slide öğesine bir Link ayarlar. Bağlantı, belirtilen slayt kimliğine göre ayarlanır.
setLinkSlide(slidePosition)LinkSlaytın göreli konumunu kullanarak, belirtilen Slide için bir Link ayarlar.
setLinkUrl(url)LinkBelirtilen boş olmayan URL dizesine bir Link ayarlar.
setRotation(angle)ImageÖğenin saat yönünün çevresindeki dönme açısını derece cinsinden ayarlar.
setTitle(title)ImageSayfa öğesinin alternatif metin başlığını ayarlar.
setTop(top)ImageÖğenin, sayfanın sol üst köşesinden ölçülen noktalardaki dikey konumunu ayarlar öğe döndürülmediğinde.
setTransform(transform)ImageSağlanan dönüşümle sayfa öğesinin dönüşümünü ayarlar.
setWidth(width)ImageNoktalar cinsinden öğenin genişliğini ayarlar. Bu, öğesinin rotasyonu yok.

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 bir öğe ilerletir.

Sayfa öğesi bir grupta yer almamalıdır.

Return

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

Yetkilendirme

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

Sayfa öğesi bir grupta yer almamalıdır.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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, aynı sayfaya, orijinalle aynı konuma yerleştirilir.

Return

PageElement: Bu sayfa öğesinin yeni kopyası.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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öntemi, dosya adına uygun uzantıyı ekler. Örneğin, "dosyam.pdf". Ancak, dosya adında son noktadan sonra gelen bölümün (varsa) mevcut bir alan olduğunu varsayar değiştirilmesi gereken uzantıdır. Sonuç olarak, "AlışverişListesi.12.25.2014" şu olur: "ShoppingList.12.25.pdf".

Günlük dönüşüm kotalarını görüntülemek için bkz. Google için Kotalar Hizmetler. Yeni oluşturulan Google Workspace alanları geçici olarak daha sıkılığa tabi olabilir kotalar.

Parametreler

AdTürAçıklama
contentTypeStringDönüşümün gerçekleştirileceği 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''ten herhangi biri de geçerlidir. Bir Google Dokümanlar dokümanı için 'text/markdown' ayrıca geçerlidir.

Return

Blob — Veriler bir blob olarak.


getBlob()

Bu görüntünün içindeki verileri blob olarak döndürün.

Return

Blob — Blob olarak gösterilen resim 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 bir 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 sayfaysa boş bir listeyi döndürür öğesinin herhangi bir bağlantı sitesi yok.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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, talepte bulunan kişinin hesabıyla etiketlenir. Böylece URL'ye sahip olan herkes etkili bir şekilde resime orijinal istek sahibi olarak erişir. sununun paylaşım ayarları değişti. 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 kapsamlardan bir 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, başlıkla birleştirilir. alternatif metin görüntüleyip okuyabilir.

Return

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

Yetkilendirme

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

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

getHeight()

Öğenin, nokta cinsinden yüksekliğini alır. Bu, öğesinin rotasyonu yok.

Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin daha fazla bilgi için Boyutlandırma ve konumlandırma sınırlamaları.

Return

Number: Sayfa öğesinin noktalardaki doğal yüksekliği veya sayfa öğesi varsa null bir yüksekliği yoktur.

Yetkilendirme

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

Sayfa öğesinin dönüşümü doğal boyutuna göre değişir. Doğal boyutu şurada kullan: ile birlikte kullanılan dönüşümlerle birlikte gösterilir.

Return

Number: Sayfa öğesinin noktalardaki doğal yüksekliği veya sayfa öğesi varsa null bir yüksekliği yoktur.

Yetkilendirme

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

Sayfa öğesinin dönüşümü doğal boyutuna göre değişir. Doğal boyutu şurada kullan: ile birlikte kullanılan dönüşümlerle birlikte gösterilir.

Return

Number: Sayfa öğesinin noktalardaki doğal genişliği veya sayfa öğesi varsa null bir genişliği yoktur.

Yetkilendirme

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

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

getLeft()

Öğenin, öğenin sol üst köşesinden ölçülen, noktalardaki yatay konumunu döndürür sayfa için bir değer girin.

Return

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

Yetkilendirme

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

Return

String: Bu nesnenin benzersiz kimliği.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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ı ile temsil edilen türünü döndürür.

Return

PageElementType: Sayfa öğesinin türü.

Yetkilendirme

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 bir 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. Resimnull yer tutucusu ya da üst öğesi yok.

Return

PageElement — Bu resim yer tutucusunun üst sayfa öğesi veya bu resim değilse null veya bir üst öğesi olmaması gerekir.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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ı sayfada iki veya daha fazla yer tutucu resim varsa her birinin benzersiz bir dizin değeri var. Resim değilse null değerini döndürür yer tutucudur.

Return

Integer — Bu resmin yer tutucu dizinidir. Resim bir yer tutucu değilse null kullanılır.

Yetkilendirme

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

Return

PlaceholderType — Bu resmin yer tutucu türü.

Yetkilendirme

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

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

getRotation()

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

Return

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

Yetkilendirme

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

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

getSourceUrl()

Görselin kaynak URL'sini (varsa) alır.

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

Return

String — Resim URL'si veya resmin kaynak URL'si yoksa null.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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, açıklama ile birleştirilerek alternatif metin görüntüleyip okuyabilir.

Return

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

Yetkilendirme

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

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

getTop()

Öğenin, sayfanın sol üst köşesinden ölçülen noktalardaki dikey konumunu alır öğede rotasyona izin verilmez.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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. Alıcı: mutlak dönüşümü hesaplama, dönüşümlerle bir sayfa öğesinin dönüşümünü önceden bağlama tüm üst gruplarının içinde yer alır. Sayfa öğesi bir grupta bulunmuyorsa 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 bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getWidth()

Nokta cinsinden öğenin genişliğini döndürür. Bu, söz konusu olduğunda öğenin sınırlayıcı kutusunun genişliğidir öğede rotasyon yok.

Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin daha fazla bilgi için Boyutlandırma ve konumlandırma sınırlamaları.

Return

Number: Sayfa öğesinin noktalardaki doğal genişliği veya sayfa öğesi varsa null bir genişliği yoktur.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 nokta 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 bitişik olacak dönüşüm.

Return

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

Yetkilendirme

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

Bir ana slaytta veya düzende PageElement yer tutucusu kaldırılırsa boş öğelerin devralması yer tutucular da kaldırılır.

Yetkilendirme

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

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

Link kaldırılır.

shape.removeLink();

replace(blobSource)

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

Resim, eklendiğinde BlobSource bir kez ve bir kopyası sununun içinde görüntülenmek üzere saklanır. Resimler 50 MB'tan küçük olmalı, 25 megapikselden büyük olmamalıdır ve PNG, JPEG veya GIF biçiminde olmalıdır.

Resmin en boy oranını korumak için resim uygun şekilde ölçeklendirilir ve ortalanır boyutunu değiştirmektir.

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 - Değişim işleminden sonra bu Image.

Yetkilendirme

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

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

replace(blobSource, crop)

Bu resmi, bir Image nesnesi tarafından açıklanan resimle değiştirir (isteğe bağlı olarak kırpılır) resmi sığdırır.

Resim, eklendiğinde BlobSource bir kez ve bir kopyası sununun içinde görüntülenmek üzere saklanır. Resimler 50 MB'tan küçük olmalı, 25 megapikselden büyük olmamalıdır 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 değerine ayarlanırsa resmi mevcut resmin boyutuna sığacak şekilde kırpar. Aksi halde, resim ölçeklendirilir ve ortalanır.

Return

Image - Değişim işleminden sonra bu Image.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 eklendiğinde URL'den bir kez getirilir ve resmin bir kopyası en iyi uygulamaları paylaşacağız. Resimler 50 MB'tan küçük olmalı, 25 megapikselden büyük olmamalıdır ve PNG, JPEG veya GIF biçiminde olur.

Sağlanan URL herkesin erişimine açık olmalı ve 2 kB'tan büyük olmamalıdır. URL kaydedilir ve getSourceUrl() üzerinden gösterildiği için resimle birlikte gösterilir.

Resmin en boy oranını korumak için resim uygun şekilde ölçeklendirilir ve ortalanır boyutunu değiştirmektir.

Parametreler

AdTürAçıklama
imageUrlStringResmin indirileceği URL.

Return

Image - Değişim işleminden sonra bu Image.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 (isteğe bağlı olarak kırpılır) resmi sığdırır.

Resim eklendiğinde URL'den bir kez getirilir ve resmin bir kopyası en iyi uygulamaları paylaşacağız. Resimlerin boyutu 50 MB'tan küçük olmalı, 25 megapikselden büyük olmamalıdır ve PNG, JPEG veya GIF biçiminde olur.

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

Parametreler

AdTürAçıklama
imageUrlStringResmin indirileceği URL.
cropBooleantrue değerine ayarlanırsa resmi mevcut resmin boyutuna sığacak şekilde kırpar. Aksi halde, resim ölçeklendirilir ve ortalanır.

Return

Image - Değişim işleminden sonra bu Image.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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, öğenin yüksekliğidir sınırlayıcı kutudur.

Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin daha fazla bilgi için Boyutlandırma ve konumlandırma sınırlamaları.

Parametreler

AdTürAçıklama
ratioNumberBu sayfa öğesinin yüksekliğinin ölçekleneceği oran.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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, öğenin genişliğidir. sınırlayıcı kutudur.

Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin daha fazla bilgi için Boyutlandırma ve konumlandırma sınırlamaları.

Parametreler

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 daha öncekileri kaldırır seçim. Bu, true üzerinden select(replace) adlı kişiyi aramakla aynıdır.

Bir komut dosyası, yalnızca komut dosyasını çalıştıran kullanıcının seçimine erişebilir ve bu işlemin komut dosyası sunuya bağlı olmalıdır.

Bu işlem, PageElement öğesinin Page üst öğ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 kapsamlardan bir 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 bu işlemin komut dosyası sunuya bağlı olmalıdır.

Yalnızca PageElement öğesini seçmek ve diğerlerini kaldırmak için bu yönteme true aktarın önceki seçim. Bu işlem ayrıca PageElement öğesinin Page üst öğesini current page selection.

Birden fazla PageElement nesnesi seçmek için false öğesini iletin. PageElement nesneler aynı Page içinde olmalıdır.

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

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

Bu durumun geçerli olduğundan emin olmak için tercih edilen yaklaşım, üst Page olmalıdır. önce Page.selectAsCurrentPage() kullanarak, sonra da bu sayfadaki sayfa öğelerini seçin.

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 bu seçim, önceki seçimlerin yerini alır; Aksi takdirde seçim önceki herhangi bir seçime eklenir.

Yetkilendirme

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

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

sendBackward()

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

Sayfa öğesi bir grupta yer almamalıdır.

Return

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

Yetkilendirme

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

Return

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

Yetkilendirme

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

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

setHeight(height)

Nokta cinsinden öğenin yüksekliğini ayarlar. Bu, öğesinin rotasyonu yok.

Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin daha fazla bilgi için Boyutlandırma ve konumlandırma sınırlamaları.

Parametreler

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

Return

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

Yetkilendirme

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

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

setLeft(left)

Noktalarda öğenin yatay konumunu ayarlar. Konum, grafiğin sol üst köşesinden sayfa için bir değer girin.

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 kapsamlardan bir 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 için bir Link ayarlar.

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

Parametreler

AdTürAçıklama
slideIndexIntegerSlaytın sıfır tabanlı dizin değeri.

Return

Link — ayarlanan Link

Yetkilendirme

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

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

setLinkSlide(slide)

Belirtilen Slide öğesine bir Link ayarlar. 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 kapsamlardan bir 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, belirtilen Slide için bir 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • 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.
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 bir veya daha fazlasıyla yetkilendirme gerektirir:

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

setRotation(angle)

Öğenin saat yönünün çevresindeki dönme açısını derece cinsinden ayarlar.

Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin daha fazla bilgi için Boyutlandırma ve konumlandırma sınırlamaları.

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

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

setTop(top)

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

Parametreler

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

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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, bu da görsel görünümlerini değiştirebilir.

Bir grupta bulunan sayfa öğesinin dönüşümünün güncellenmesi, yalnızca bu sayfa öğesini kullanabilirsiniz. grubu veya diğer sayfa öğelerinin dönüşümlerini etkilemez: grubu.

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

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

setWidth(width)

Noktalar cinsinden öğenin genişliğini ayarlar. Bu, öğesinin rotasyonu yok.

Bu yöntem tüm sayfa öğeleriyle uyumlu değildir. Hangi sayfa öğelerinin daha fazla bilgi için Boyutlandırma ve konumlandırma sınırlamaları.

Parametreler

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

Return

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

Yetkilendirme

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

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