REST Resource: presentations.pages

Kaynak: Sayfa

Bir sunudaki 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. Son okuma işleminden bu yana sunum düzeltmesinin değişmediğini doğrulamak 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 zaman içinde değişebilir. Döndürülen düzeltme kimliğinin, yalnızca iade edildikten sonra 24 saat boyunca geçerli olacağı garanti edilir ve bu kimlik kullanıcılar arasında paylaşılamaz. Düzeltme kimliği, çağrılar arasında değişmediyse sunum değişmemiştir. Buna karşılık, aynı sunu ve kullanıcı için değişen bir kimlik genellikle sununun güncellendiği anlamına gelir. Ancak kimliğin değişmesi, kimlik biçimi değişiklikleri gibi dahili faktörlerden de kaynaklanabilir.
pageProperties

object (PageProperties)

Sayfanın özellikleri.
Birlik alanı properties. Her sayfa türüne özgü özellikler. Ana videolar için ek mülk gerekmez. properties yalnızca aşağıdakilerden biri olabilir:
slideProperties

object (SlideProperties)

Belirli mülkleri kaydırın. Yalnızca pageType = SLIDE ise ayarlanır.
layoutProperties

object (LayoutProperties)

Düzene özgü özellikler. Yalnızca pageType = LAYOUT ise ayarlayın.
notesProperties

object (NotesProperties)

Notlara özgü özellikler. Yalnızca pageType = NOTES ise ayarlanır.
masterProperties

object (MasterProperties)

Belirli mülklerde ana hatlar oluşturun. 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

Bir 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ü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.

Yeni oluşturulan Group için ilk dönüştürme işlemi her zaman kimlik dönüştürme işlemidir.
title

string

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

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

string

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

Bu alan, Group öğeleri için desteklenmiyor.
Birlik alanı element_kind. Bu PageElement'ın temsil ettiği öğenin türü. Her mesaj, söz konusu sayfa öğesi türüne özgü tüm özellikleri içerir. element_kind yalnızca aşağıdakilerden 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 sayfa öğ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)

Konuşmacı köşesi.

Grup

Birleştirilmiş bir PageElements 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

Word art'ı 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ışının özellikleri.

SpeakerSpotlightProperties

SpeakerSpotlight öğesinin özellikleri.

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

object (Outline)

Konuşmacı köşesinin ana hatları. Ayarlanmazsa kenarlık olmaz.
shadow

object (Shadow)

Konuşmacının kamera akışının gölgesi. Ayarlanmazsa gölgesi olmaz.

SlideProperties

Page özelliğinin yalnızca pageType değeri SLIDE olan sayfalarla alakalı ö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 öğenin nesne kimliği. Bu özellik salt okunur.
notesPage

object (Page)

Bu slajdı ilişkilendirdiğiniz notlar sayfası. Slaytlar konuşmacı notlarıyla yazdırıldığında veya dışa aktarıldığında notlar sayfasının görsel görünümünü tanımlar. Notlar sayfası, notes master öğesinden özellikleri devralır. Notlar sayfasındaki BODY türüne sahip yer tutucu şekil, bu slaytla ilgili konuşmacı notlarını içerir. Bu şeklin kimliği speakerNotesObjectId alanıyla tanımlanır. Notlar sayfası, konuşmacı notları şeklinin metin içeriği ve stilleri hariç salt okunurdur. Bu özellik salt okunur.
isSkipped

boolean

Slaytın sunu modunda atlanıp atlanmadığı. Varsayılan değer yanlıştır.

LayoutProperties

Page özelliklerinin geçerli olduğu sayfalar yalnızca pageType özelliği LAYOUT olan sayfalardır.

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

string

Bu sayfa düzeninin temel aldığı ana öğenin kimliği.
name

string

Sayfanın adı.
displayName

string

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

NotesProperties

Page özelliğinin yalnızca pageType NOTES olan sayfalarla alakalı özellikleri.

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

string

Bu notlar sayfasındaki, ilgili slaytla ilgili konuşmacı notlarını içeren şeklin nesne kimliği. Gerçek şekil her zaman notlar sayfasında 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 öğesini içeren sayfalarla alakalı Page özellikleri.

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

string

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

PageProperties

Page öğesinin özellikleri.

Sayfa, üst sayfadan özellikleri 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. Ayarlanmazsa arka plan doldurma, varsa bir üst sayfadan devralınır. Sayfanın üst öğesi yoksa arka plan doldurma işlemi varsayılan olarak Slaytlar düzenleyicisindeki ilgili doldurma işlemine ayarlanır.
colorScheme

object (ColorScheme)

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

Yalnızca ilk 12 ThemeColorType'nin beton renkleri düzenlenebilir. Ayrıca, yalnızca Master sayfalarındaki renk şeması güncellenebilir. Alanın güncellenmesi için ilk 12 ThemeColorType'in tümünün belirli 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),

  // 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 dolgusu mülk durumu.

Bir sayfadaki dolguyu güncellediğinizde, aynı istekte başka bir değer belirtilmediği sürece bu alan RENDERED olarak güncellenir. 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.
Birleştirme alanı kind. Arka plan dolgusunun türü. kind şunlardan yalnızca biri olabilir:
solidFill

object (SolidFill)

Düz renkli dolgu.
stretchedPictureFill

object (StretchedPictureFill)

Uzatılmış resim dolgusu.

StretchedPictureFill

Uzatılmış 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

İçerik URL'sini okuma:

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

contentUrl değerini yazma:

Resim, ekleme sırasında bir kez getirilir ve sunu içinde gösterilmek üzere bir kopyası saklanır. Resimler 50 MB'tan küçük, 25 megapikselden büyük olamaz 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

Bir tema rengi türünü temsil ettiği somut renkle 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 somut renk.

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.