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

  // Union field properties can be only one of the following:
  "slideProperties": {
    object (SlideProperties)
  },
  "layoutProperties": {
    object (LayoutProperties)
  },
  "notesProperties": {
    object (NotesProperties)
  },
  "masterProperties": {
    object (MasterProperties)
  }
  // End of list of possible types for union field properties.
}
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. Sunu 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 sunu için 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. Döndürülen düzeltme kimliği, iade edildikten sonraki 24 saat boyunca geçerli olur ve kullanıcılar arasında paylaşılamaz. Çağrılar arasında düzeltme kimliği değişmezse sunu değişmemiştir. Öte yandan, kimlik değiştirilmesi (aynı sunu ve kullanıcı için) genellikle sununun güncellendiği anlamına gelir. Ancak kimliğin değiştirilmesi, kimlik biçimi değişiklikleri gibi dahili faktörlerden de kaynaklanabilir.
pageProperties

object (PageProperties)

Sayfanın özellikleri.
Birleştirme alanı properties. Her bir sayfa türüne özel özellikler. Ana örnekler herhangi bir ek özellik gerektirmez. properties şunlardan yalnızca biri olabilir:
slideProperties

object (SlideProperties)

Slayta özgü özellikler. Yalnızca pageType = SLAYT olduğunda ayarlayın.
layoutProperties

object (LayoutProperties)

Düzene özgü özellikler. Yalnızca pageType = LAYOUT değeri geçerliyse ayarlanır.
notesProperties

object (NotesProperties)

Notes'a özgü özellikler. Yalnızca pageType = NOTES ise ayarlanır.
masterProperties

object (MasterProperties)

Belirli mülklerde uzmanlaşın. Yalnızca pageType = MASTER ise ayarlanır.

PageType

Sayfanın türü.

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

PageElement

Sayfada oluşturulan görsel öğe.

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

  // Union field element_kind can be only one of the following:
  "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 list of possible types for union field element_kind.
}
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 bağlayın. Sayfa öğesi bir grupta değilse mutlak dönüşümü, bu alandaki değerle aynı olur.

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örüntülemek için açıklamayla birleştirilir.

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

string

Sayfa öğesinin açıklaması. Alternatif metni görüntülemek için başlıkla birleştirilir.

Alan, Group öğeleri için desteklenmiyor.
Birleştirme alanı element_kind. Bu PageElement öğesinin temsil ettiği öğe türü. Her mesaj, söz konusu sayfa öğesi türüne özgü özellikleri içerir. element_kind şunlardan yalnızca biri olabilir:
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)

Satır 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ılan grafikler resim olarak gösterilir.
speakerSpotlight

object (SpeakerSpotlight)

Öne çıkan konuşmacı.

Grup

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

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

object (PageElement)

Gruptaki öğelerin koleksiyonu. Grubun minimum boyutu 2'dir.

WordArt

Word art'ı temsil eden PageElement türü.

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

string

Word art olarak işlenen metin.

SpeakerSpotlight

Öne çıkan konuşmacıyı temsil eden PageElement türü.

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

object (SpeakerSpotlightProperties)

Konuşmacı köşesinin özellikleri.

SpeakerSpotlightProperties

SpeakerSpotlight özellikleri.

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

object (Outline)

Konuşmacı köşesinin ana hatları. Ayarlanmazsa dış çizgisi yoktur.
shadow

object (Shadow)

Konuşmacı köşesinin gölgesi. Ayarlanmazsa gölge olmaz.

SlideProperties

Yalnızca pageType SLAYT'ı içeren sayfalarla alakalı Page özellikleri.

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

string

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

string

Bu slaytın temel aldığı ana slaydın nesne kimliği. Bu özellik salt okunurdur.
notesPage

object (Page)

Bu slaydın ilişkili olduğu notlar sayfası. Slaytları konuşmacı notlarıyla birlikte yazdırırken veya dışa aktarırken, notlar sayfasının görsel görünümünü tanımlar. Notlar sayfası, özellikleri notes master öğesinden devralır. Notlar sayfasındaki BODY türündeki yer tutucu şekli, bu slayta ilişkin 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 atlanmayacağı. Varsayılan olarak false değerine ayarlanır.

LayoutProperties

Page özellikleri yalnızca pageType LAYOUT değeri olan sayfalarla alakalıdır.

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

string

Bu düzenin temel aldığı ana slaydın nesne kimliği.
name

string

Düzenin adı.
displayName

string

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

NotesProperties

Yalnızca pageType NOTES bulunan sayfalarla alakalı Page özellikleri.

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

string

Bu notlar sayfasındaki şeklin ilgili slayta ilişkin konuşmacı notlarını içeren nesne kimliği. Asıl ş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ı 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 sayfalarla alakalı Page özellikleri.

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

string

Ana kopyanın kullanıcılar tarafından okunabilen adı.

PageProperties

Page özellikleri.

Sayfa, özellikleri üst sayfadan devralır. Sayfa türüne bağlı olarak, hiyerarşi 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. Ayarlanmadan bırakılırsa arka plan dolgusu varsa üst sayfadan devralınır. Sayfanın üst öğesi yoksa arka plan dolgusu varsayılan olarak Slaytlar düzenleyicisinde ilgili dolguya ayarlanır.
colorScheme

object (ColorScheme)

Sayfanın renk şeması. Ayarlanmazsa renk şeması bir üst sayfadan devralınır. Sayfanın üst öğesi yoksa renk şeması, Slaytlar düzenleyicisindeki varsayılan değerlere uygun olan varsayılan bir Slaytlar renk şemasını kullanır.

Yalnızca ilk 12 ThemeColorType için somut renkler düzenlenebilir. Ayrıca, yalnızca Master sayfalarındaki renk şeması güncellenebilir. Alanı güncellemek için ilk 12 ThemeColorType'ın tamamından somut renklerine eşlemeleri içeren bir renk şeması sağlanmalıdır. Kalan ThemeColorTypes için renkler yok sayılacak.

PageBackgroundFill

Sayfanın arka plan dolgusu.

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

  // Union field kind can be only one of the following:
  "solidFill": {
    object (SolidFill)
  },
  "stretchedPictureFill": {
    object (StretchedPictureFill)
  }
  // End of list of possible types for union field kind.
}
Alanlar
propertyState

enum (PropertyState)

Arka plan dolgu özelliği durumu.

Bir sayfadaki dolguyu güncellemek, aynı istekte başka bir değer belirtilmediği sürece bu alanı dolaylı yoldan RENDERED olarak günceller. Bir sayfada dolgu olmaması için bu alanı NOT_RENDERED olarak ayarlayın. Bu durumda, aynı istekte ayarlanan diğer dolgu alanları yoksayılır.
Birleştirme alanı kind. Arka plan dolgusunun türü. kind şunlardan yalnızca biri olabilir:
solidFill

object (SolidFill)

Düz renk dolgusu.
stretchedPictureFill

object (StretchedPictureFill)

Uzatılmış resim dolgusu.

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 okuması:

Varsayılan ömrü 30 dakika olan bir resmin URL'si. Bu URL, istekte bulunan kişinin hesabıyla etiketlenmiştir. URL'ye sahip herkes, resme orijinal istek sahibi olarak etkin bir şekilde erişir. Sununun paylaşım ayarları değişirse resme erişim kaybedilebilir.

contentUrl yazılıyor:

Resim, ekleme zamanında bir kez getirilir 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ış renk paleti.

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

object (ThemeColorPair)

ThemeColorType ve karşılık gelen beton renk çiftleri.

ThemeColorPair

Tema rengi türünü temsil ettiği somut 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 renk türüne karşılık gelen beton rengi.

Yöntemler

get

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

getThumbnail

 Sunuda belirtilen sayfanın en son sürümünün küçük resmini oluşturur ve küçük resme URL döndürür.