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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of mutually exclusive fields.
}
Alanlar
objectId

string

Bu sayfanın nesne kimliği. Page ve PageElement tarafından kullanılan nesne kimlikleri aynı ad alanını paylaşır.
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 zamanla değişebilir. İade edilen düzeltme kimliğinin, iade edildikten sonraki 24 saat boyunca geçerli olması 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ı sunum ve kullanıcı için kimliğin değiştirilmesi ise genellikle sunumun güncellendiği anlamına gelir. Ancak, değişen kimlikler, kimlik biçimi değişiklikleri 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ünümü 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 içinde en fazla bir alan ayarlanır:
slideProperties

object (SlideProperties)

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

object (LayoutProperties)

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

object (NotesProperties)

Notlara özel özellikler. Yalnızca pageType = NOTES ise ayarlayın.
masterProperties

object (MasterProperties)

Belirli özellikleri ustalaşarak kullanma Yalnızca pageType = MASTER ise ayarlanır.
Karşılıklı olarak hariç tutulan 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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "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)
  }
  // End of mutually exclusive fields.
}
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şır.
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ü, 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.

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ü özellikleri içerir. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt içinde 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)

Bir resim sayfası öğesi.
video

object (Video)

Video sayfası öğesi.
line

object (Line)

Çizgi sayfası öğesi.
table

object (Table)

Tablo sayfası öğesi.
wordArt

object (WordArt)

Word art 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ı
Karşılıklı olarak hariç tutulan alanların sonu.

Grup

Birleştirilmiş bir PageElement koleksiyonunu temsil eden PageElement türü.

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

object (PageElement)

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

WordArt

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

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

string

Word art olarak oluşturulan metin.

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ı özelliğinin ana hatları. Ayarlanmazsa ana hat olmaz.
shadow

object (Shadow)

Konuşmacının kamera akışı özelliğinin gölgesi. Ayarlanmazsa gölge olmaz.

SlideProperties

Page özelliğinin yalnızca pageType SLIDE değerine sahip sayfalar için geçerli olan ö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 slaytla ilişkili 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ı, özellikleri notes master öğesinden devralır. Notlar sayfasındaki BODY türündeki yer tutucu şekli, 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 hariç 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 değerine sahip 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 okunabilir adı.

NotesProperties

Yalnızca pageType NOTES değerine sahip sayfalar için geçerli olan Page özellikleri.

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

string

Bu notlar sayfasında, ilgili slaytın konuşmacı notlarını içeren ş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

Page özelliklerinden yalnızca pageType MASTER değerine sahip sayfalar için geçerli olanlar.

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

string

Ana öğenin kullanıcılar tarafından okunabilir 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üncellemek için ilk 12 ThemeColorType'ın tümünün somut renkleriyle eşlemelerini 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),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of mutually exclusive fields.
}
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ı dolaylı 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 içinde en fazla bir alan ayarlanır:
solidFill

object (SolidFill)

Düz renk dolgusu.
stretchedPictureFill

object (StretchedPictureFill)

Uzatılmış resim dolgusu.
Karşılıklı olarak hariç tutulan alanların sonu.

StretchedPictureFill

Uzatılmış resim dolgusu. Sayfa veya sayfa öğesi tamamen belirtilen resimle doldurulmuş. 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 talepte bulunan kişi 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çiminde 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ış renklerin 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 aracılığıyla bir CommentThread'ye sabitlenmiş bir Page içindeki tüm konumların listesini içerir. Birden çok ayrı bağlantı, 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 sayfadaki, 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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "shapeTextAnchors": {
    object (ShapeTextAnchors)
  },
  "tableCellAnchors": {
    object (TableCellAnchors)
  }
  // End of mutually exclusive fields.
}
Alanlar
objectId

string

Yalnızca çıkış. Yorum ileti dizisinin sabitlendiği sayfa veya sayfa öğesi.
Yalnızca çıkış. Yorum ileti dizisinin sabitlendiği sayfa öğesindeki metin aralıkları. Yorum bağlantısı, öğe içindeki bir metin aralığı yerine tüm sayfa veya sayfa öğesi içinse boş olur. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt içinde 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.
Karşılıklı olarak hariç tutulan alanların sonu.

ShapeTextAnchors

Bir şekil içindeki, yorum bağlantısıyla kaplı metin aralıklarını temsil eder.

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

object (TextRange)

Yorum bağlantısı tarafından kapsanan 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ı desteklemek 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ı desteklemek için Int32Value'dur.

TableCellAnchors

Bir yorum tutturucusuyla kapsanan tablodaki tablo hücresi aralıklarını temsil eder.

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

object (TableCellTextRanges)

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

TableCellTextRanges

Bir tablo hücresinde, yorum bağlantısıyla kapsanan 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.