REST Resource: presentations.pages

Kaynak: Sayfa

Sunudaki bir sayfa.

JSON gösterimi 
{
  "objectId": string,
  "pageType": enum (PageType),
  "pageElements": [
    {
      object (PageElement)
    }
  ],
  "revisionId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "commentAnchors": [
    {
      object (CommentAnchor)
    }
  ],
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode),

  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
}
Alanlar
objectId

string

Bu sayfanın nesne kimliği. Page ve PageElement tarafından kullanılan nesne kimlikleri aynı ad alanını paylaşıyor.
pageType

enum (PageType)

Sayfanın türü.
pageElements[]

object (PageElement)

Sayfada oluşturulan sayfa öğeleri.
revisionId

string

Yalnızca çıkış. Sununun düzeltme kimliği. Sunum düzeltmesinin son okuma işleminden bu yana değişmediğini onaylamak için güncelleme isteklerinde kullanılabilir. Yalnızca kullanıcının sunuyu düzenleme erişimi varsa doldurulur.

Düzeltme kimliği, sıralı bir sayı değil opak bir dizedir. Düzeltme kimliğinin biçimi zaman içinde değişebilir. Döndürülen düzeltme kimliğinin yalnızca döndürüldükten sonraki 24 saat içinde geçerli olduğu garanti edilir ve kullanıcılar arasında paylaşılamaz. Çağrılar arasında düzeltme kimliği değişmediyse sunum değişmemiştir. Aynı şekilde, aynı sunum ve kullanıcı için kimliğin değişmesi genellikle sunumun güncellendiği anlamına gelir. Ancak değişen kimlik, kimlik biçimindeki değişiklikler gibi dahili faktörlerden de kaynaklanabilir.
pageProperties

object (PageProperties)

Sayfanın özellikleri.
commentAnchors[]

object (CommentAnchor)

Yalnızca çıkış. Sayfada bulunan yorum bağlantıları.
comments[]

object (CommentThread)

Yalnızca çıkış. Sayfayla ilişkili yorum ileti dizileri. Yalnızca sayfa, doldurulmuş bir commentsViewMode ile GetPageRequest üzerinden getirildiyse doldurulur. Aksi takdirde, yorumlar Presentation içinde GetPresentationRequest üzerinden döndürülür.
commentsViewMode

enum (CommentsViewMode)

Yalnızca çıkış. Sayfaya uygulanan yorum görüntüleme modu. Yalnızca sayfa, doldurulmuş bir commentsViewMode ile GetPageRequest üzerinden getirildiyse doldurulur.
Her sayfa türüne özel özellikler. Ana öğeler için ek özellik gerekmez. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
slideProperties

object (SlideProperties)

Slayta özgü özellikler. Yalnızca pageType = SLIDE ise ayarlanır.
layoutProperties

object (LayoutProperties)

Düzene özgü özellikler. Yalnızca pageType = LAYOUT ise ayarlanır.
notesProperties

object (NotesProperties)

Belirli mülkler için notlar. Yalnızca pageType = NOTES ise ayarlayın.
masterProperties

object (MasterProperties)

Belirli mülklerde uzmanlaşın. Yalnızca pageType = MASTER ise ayarlanır.
Birbirini dışlayan alanların sonu.

PageType

Sayfanın türü.

Sıralamalar
SLIDE Slayt sayfası.
MASTER Bir ana slayt sayfası.
LAYOUT Bir düzen sayfası.
NOTES Notlar sayfası.
NOTES_MASTER Notlar ana sayfası.

PageElement

Bir sayfada oluşturulan görsel öğe.

JSON gösterimi 
{
  "objectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  },
  "title": string,
  "description": string,

  "elementGroup": {
    object (Group)
  },
  "shape": {
    object (Shape)
  },
  "image": {
    object (Image)
  },
  "video": {
    object (Video)
  },
  "line": {
    object (Line)
  },
  "table": {
    object (Table)
  },
  "wordArt": {
    object (WordArt)
  },
  "sheetsChart": {
    object (SheetsChart)
  },
  "speakerSpotlight": {
    object (SpeakerSpotlight)
  }
}
Alanlar
objectId

string

Bu sayfa öğesinin nesne kimliği. google.apps.slides.v1.Page ve google.apps.slides.v1.PageElement tarafından kullanılan nesne kimlikleri aynı ad alanını paylaşıyor.
size

object (Size)

Sayfa öğesinin boyutu.
transform

object (AffineTransform)

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

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ü, üst gruplarının tüm dönüşümleriyle önceden birleştirin. Sayfa öğesi bir grupta değilse mutlak dönüşümü bu alandaki değerle aynıdır.

Yeni oluşturulan Group için ilk dönüşüm her zaman kimlik dönüşümüdür.
title

string

Sayfa öğesinin başlığı. Alternatif metni göstermek için açıklamayla birlikte kullanılır.

Alan, Group öğeleri için desteklenmez.
description

string

Sayfa öğesinin açıklaması. Alternatif metni göstermek için başlıkla birlikte kullanılır.

Alan, Group öğeleri için desteklenmez.
Bu PageElement'in temsil ettiği öğe türü. Her mesaj, söz konusu sayfa öğesi türüne özgü tüm özellikleri içerir. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
elementGroup

object (Group)

Tek bir birim olarak birleştirilmiş sayfa öğeleri koleksiyonu.
shape

object (Shape)

Genel bir şekil.
image

object (Image)

Resim sayfası öğesi.
video

object (Video)

Video sayfası öğesi.
line

object (Line)

Çizgi sayfası öğesi.
table

object (Table)

Tablo sayfası öğesi.
wordArt

object (WordArt)

WordArt sayfa öğesi.
sheetsChart

object (SheetsChart)

Google E-Tablolar'dan yerleştirilmiş bağlı bir grafik. Bağlantısı kaldırılmış grafikler resim olarak gösterilir.
speakerSpotlight

object (SpeakerSpotlight)

Öne Çıkan Konuşmacı
Birbirini dışlayan alanların sonu.

Grup

PageElement'lerin birleştirilmiş koleksiyonunu temsil eden bir PageElement türü.

JSON gösterimi 
{
  "children": [
    {
      object (PageElement)
    }
  ]
}
Alanlar
children[]

object (PageElement)

Gruptaki öğelerin koleksiyonu. Bir grubun minimum boyutu 2'dir.

WordArt

WordArt'ı temsil eden bir PageElement türü.

JSON gösterimi 
{
  "renderedText": string
}
Alanlar
renderedText

string

Metin, WordArt olarak oluşturulur.

SpeakerSpotlight

Konuşmacının Kamera Akışı'nı temsil eden bir PageElement türü.

JSON gösterimi 
{
  "speakerSpotlightProperties": {
    object (SpeakerSpotlightProperties)
  }
}
Alanlar
speakerSpotlightProperties

object (SpeakerSpotlightProperties)

Konuşmacının kamera akışı özelliğinin özellikleri.

SpeakerSpotlightProperties

SpeakerSpotlight öğesinin özellikleri.

JSON gösterimi 
{
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  }
}
Alanlar
outline

object (Outline)

Öne Çıkan Konuşmacı'nın ana hattı. Ayarlanmamışsa ana hat yoktur.
shadow

object (Shadow)

Öne Çıkan Konuşmacı özelliğinin gölgesi. Ayarlanmamışsa gölge yoktur.

SlideProperties

Yalnızca pageType SLIDE olan sayfalar için geçerli olan Page özellikleri.

JSON gösterimi 
{
  "layoutObjectId": string,
  "masterObjectId": string,
  "notesPage": {
    object (Page)
  },
  "isSkipped": boolean
}
Alanlar
layoutObjectId

string

Bu slaytın temel alındığı düzenin nesne kimliği. Bu özellik salt okunurdur.
masterObjectId

string

Bu slaytın temel alındığı ana öğenin nesne kimliği. Bu özellik salt okunurdur.
notesPage

object (Page)

Bu slaytın ilişkili olduğu notlar sayfası. Notlar sayfasının, konuşmacı notları içeren slaytlar yazdırılırken veya dışa aktarılırken nasıl görüneceğini tanımlar. Notlar sayfası, notes master öğesinden özellikleri devralır. Notlar sayfasındaki BODY türündeki yer tutucu şekil, bu slaytın konuşmacı notlarını içerir. Bu şeklin kimliği speakerNotesObjectId alanı tarafından tanımlanır. Notlar sayfası, konuşmacı notları şeklinin metin içeriği ve stilleri dışında salt okunurdur. Bu özellik salt okunurdur.
isSkipped

boolean

Slaytın sunu modunda atlanıp atlanmadığı. Varsayılan olarak false değerine ayarlanır.

LayoutProperties

Page özellikleri yalnızca pageType LAYOUT olan sayfalar için geçerlidir.

JSON gösterimi 
{
  "masterObjectId": string,
  "name": string,
  "displayName": string
}
Alanlar
masterObjectId

string

Bu düzenin temel alındığı ana öğenin nesne kimliği.
name

string

Düzenin adı.
displayName

string

Düzenin, kullanıcılar tarafından okunabilen adı.

NotesProperties

Yalnızca pageType NOTLAR olan sayfalar için geçerli olan Page özellikleri.

JSON gösterimi 
{
  "speakerNotesObjectId": string
}
Alanlar
speakerNotesObjectId

string

İlgili slaytın konuşmacı notlarını içeren bu notlar sayfasındaki şeklin nesne kimliği. Gerçek şekil, notlar sayfasında her zaman bulunmayabilir. Bu nesne kimliğini kullanarak metin eklediğinizde şekil otomatik olarak oluşturulur. Bu durumda, gerçek şeklin farklı bir nesne kimliği olabilir. presentations.get veya pages.get işlemi her zaman en son nesne kimliğini döndürür.

MasterProperties

Yalnızca pageType MASTER olan sayfalar için geçerli olan Page özellikleri.

JSON gösterimi 
{
  "displayName": string
}
Alanlar
displayName

string

Ana öğenin kullanıcılar tarafından okunabilen adı.

PageProperties

Page öğesinin özellikleri.

Sayfa, özellikleri üst sayfadan devralır. Hiyerarşi, sayfa türüne bağlı olarak SlideProperties veya LayoutProperties içinde tanımlanır.

JSON gösterimi 
{
  "pageBackgroundFill": {
    object (PageBackgroundFill)
  },
  "colorScheme": {
    object (ColorScheme)
  }
}
Alanlar
pageBackgroundFill

object (PageBackgroundFill)

Sayfanın arka plan dolgusu. Ayarlanmamışsa arka plan dolgusu, varsa üst sayfadan devralınır. Sayfanın üst öğesi yoksa arka plan dolgusu, Slaytlar düzenleyicisindeki ilgili dolguya ayarlanır.
colorScheme

object (ColorScheme)

Sayfanın renk şeması. Ayarlanmamışsa renk şeması üst sayfadan devralınır. Sayfanın üst öğesi yoksa renk şeması, Slaytlar düzenleyicisindeki varsayılanlarla eşleşen varsayılan bir Slaytlar renk şeması kullanır.

Yalnızca ilk 12 ThemeColorType'nin somut renkleri düzenlenebilir. Ayrıca, yalnızca Master sayfalarındaki renk şeması güncellenebilir. Alan güncellenirken ilk 12 ThemeColorType'ın tümünden somut renklere eşlemeler içeren bir renk şeması sağlanmalıdır. Kalan ThemeColorTypes için renkler yoksayılır.

PageBackgroundFill

Sayfa arka plan dolgusu.

JSON gösterimi 
{
  "propertyState": enum (PropertyState),

  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
}
Alanlar
propertyState

enum (PropertyState)

Arka plan dolgusu özelliği durumu.

Bir sayfadaki dolguyu güncellemek, aynı istekte başka bir değer belirtilmediği sürece bu alanı örtülü olarak RENDERED olarak günceller. Bir sayfada dolgu olmaması için bu alanı NOT_RENDERED olarak ayarlayın. Bu durumda, aynı istekte ayarlanan diğer tüm doldurma alanları yoksayılır.
Arka plan dolgusunun türü. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
solidFill

object (SolidFill)

Düz renk dolgu.
stretchedPictureFill

object (StretchedPictureFill)

Genişletilmiş resim dolgusu.
Birbirini dışlayan alanların sonu.

StretchedPictureFill

Genişletilmiş resim dolgusu. Sayfa veya sayfa öğesi tamamen belirtilen resimle doldurulur. Resim, kapsayıcısına sığacak şekilde uzatılır.

JSON gösterimi 
{
  "contentUrl": string,
  "size": {
    object (Size)
  }
}
Alanlar
contentUrl

string

contentUrl'yi okuma:

Varsayılan kullanım süresi 30 dakika olan bir resmin URL'si. Bu URL, istekte bulunan kullanıcının hesabıyla etiketlenir. URL'ye sahip herkes, resme orijinal talep eden kullanıcı gibi erişir. Sunumun paylaşım ayarları değişirse resme erişim kaybedilebilir.

contentUrl yazma:

Resim, ekleme sırasında 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çimlerinden birinde olmalıdır.

Sağlanan URL en fazla 2 KB uzunluğunda olabilir.
size

object (Size)

Resim dolgusunun orijinal boyutu. Bu alan salt okunurdur.

ColorScheme

Bir sayfa için önceden tanımlanmış renk paleti.

JSON gösterimi 
{
  "colors": [
    {
      object (ThemeColorPair)
    }
  ]
}
Alanlar
colors[]

object (ThemeColorPair)

ThemeColorType ve ilgili somut renk çiftleri.

ThemeColorPair

Tema rengi türünü temsil ettiği renge eşleyen bir çift.

JSON gösterimi 
{
  "type": enum (ThemeColorType),
  "color": {
    object (RgbColor)
  }
}
Alanlar
type

enum (ThemeColorType)

Tema renginin türü.
color

object (RgbColor)

Yukarıdaki tema rengi türüne karşılık gelen beton rengi.

CommentAnchor

Aynı anchorId üzerinden bir CommentThread'ye sabitlenmiş bir Page içindeki tüm konumların listesini içerir. Birden çok ayrı sabitleme, aynı konuma (Page içinde veya farklı sayfalarda) işaret edebilir.

JSON gösterimi 
{
  "anchorId": string,
  "objectAnchors": [
    {
      object (ObjectAnchor)
    }
  ]
}
Alanlar
anchorId

string

Yalnızca çıkış. Yorum bağlantısının benzersiz kimliği.
objectAnchors[]

object (ObjectAnchor)

Yalnızca çıkış. Bir sayfada, bağlantı kimliğine referans veren tüm nesne kimliği tabanlı konumlar.

ObjectAnchor

Bir Slaytlar nesnesine (ör. Page veya PageElement) bağlı yorum tutturma noktası verilerini temsil eder.

JSON gösterimi 
{
  "objectId": string,

  "shapeTextAnchors": {
    object (ShapeTextAnchors)
  },
  "tableCellAnchors": {
    object (TableCellAnchors)
  }
}
Alanlar
objectId

string

Yalnızca çıkış. Yorum ileti dizisinin sabitlendiği sayfa veya sayfa öğesi.
Yalnızca çıkış. Yorum dizisinin sabitlendiği sayfa öğesindeki metin aralıkları. Yorum bağlantısı, öğe içindeki bir metin aralığı yerine sayfanın tamamı veya sayfa öğesi içinse boş olur. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
shapeTextAnchors

object (ShapeTextAnchors)

Şeklin [text][google.apps.slides.v1.Shape.TextContent] özelliğindeki metin aralıklarına sabitlenmiş yorumlar içeren Shapes için doldurulur.
tableCellAnchors

object (TableCellAnchors)

Tablonun bir veya daha fazla hücresindeki metin aralıklarına sabitlenmiş yorumlar içeren Tables için doldurulur.
Birbirini dışlayan alanların sonu.

ShapeTextAnchors

Bir yorum bağlantısı tarafından kapsanan şekil içindeki metin aralıklarını temsil eder.

JSON gösterimi 
{
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
Alanlar
ranges[]

object (TextRange)

Yorum bağlantısının kapsadığı metin aralıklarının listesi.

TextRange

Bir şekil veya tablo hücresinin text içinde bitişik bir metin aralığı belirtir.

JSON gösterimi 
{
  "startIndex": integer,
  "endIndex": integer
}
Alanlar
startIndex

integer

Başlangıç aralığının sıfır tabanlı dizini. Bu alan, açık uçlu aralıklarla gelecekteki kullanım alanlarını karşılamak için Int32Value'dur.
endIndex

integer

Aralığın sonunun sıfır tabanlı dizini. Bu alan, açık uçlu aralıklarla gelecekteki kullanım alanlarını karşılamak için Int32Value'dur.

TableCellAnchors

Yorum tutturucusuyla kapsanan bir tablodaki tablo hücresi aralıklarını temsil eder.

JSON gösterimi 
{
  "cellRanges": [
    {
      object (TableCellTextRanges)
    }
  ]
}
Alanlar
cellRanges[]

object (TableCellTextRanges)

Tablodaki metnin, tablodaki bağlantı tarafından kapsandığı tüm tablo hücrelerinin listesi.

TableCellTextRanges

Bir yorum bağlantısı tarafından kapsanan tablo hücresindeki metin aralıklarını temsil eder.

JSON gösterimi 
{
  "cellLocation": {
    object (TableCellLocation)
  },
  "ranges": [
    {
      object (TextRange)
    }
  ]
}
Alanlar
cellLocation

object (TableCellLocation)

Tablo hücresinin konumu.
ranges[]

object (TextRange)

Bu hücredeki sabitleme tarafından kapsanan tüm metin aralıklarının listesi.

Yöntemler

get

 Sunumdaki belirtilen sayfanın en son sürümünü alır.

getThumbnail

 Sunudaki belirtilen sayfanın en son sürümünün küçük resmini oluşturur ve küçük resim görüntüsünün URL'sini döndürür.