REST Resource: presentations.pages

संसाधन: पेज

प्रज़ेंटेशन में मौजूद कोई पेज.

JSON के काेड में दिखाना 
{
  "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.
}
फ़ील्ड
objectId

string

इस पेज के लिए ऑब्जेक्ट आईडी. Page और PageElement, जिन ऑब्जेक्ट आईडी का इस्तेमाल करते हैं उनका नेमस्पेस एक ही होता है.
pageType

enum (PageType)

पेज किस तरह का है.
pageElements[]

object (PageElement)

पेज पर रेंडर किए गए पेज एलिमेंट.
revisionId

string

सिर्फ़ आउटपुट के लिए. प्रज़ेंटेशन का रिविज़न आईडी. इसका इस्तेमाल अपडेट के अनुरोधों में यह दावा करने के लिए किया जा सकता है कि पिछली बार पढ़े गए बदलाव के बाद से, प्रज़ेंटेशन में किया गया बदलाव नहीं बदला है. प्रज़ेंटेशन में बदलाव करने का ऐक्सेस होने पर ही, जानकारी अपने-आप भर जाती है.

संशोधन आईडी कोई आनुक्रमिक संख्या नहीं, बल्कि एक ओपेक स्ट्रिंग है. संशोधन आईडी का फ़ॉर्मैट समय के साथ बदल सकता है. इस बात की गारंटी है कि वापस किया गया वर्शन आईडी, वापस करने के 24 घंटे बाद तक ही मान्य रहेगा. साथ ही, इसे अन्य उपयोगकर्ताओं के साथ शेयर नहीं किया जा सकता. अगर कॉल के बीच रिविज़न आईडी में कोई बदलाव नहीं होता है, तो इसका मतलब है कि प्रज़ेंटेशन में बदलाव नहीं हुआ है. इसके उलट, एक ही प्रज़ेंटेशन और उपयोगकर्ता के लिए बदले गए आईडी का मतलब है कि प्रज़ेंटेशन को अपडेट कर दिया गया है. हालांकि, आईडी फ़ॉर्मैट में बदलाव जैसी अंदरूनी वजहों से भी आईडी बदल सकता है.
pageProperties

object (PageProperties)

पेज की प्रॉपर्टी.
यूनियन फ़ील्ड properties. हर पेज टाइप के लिए खास प्रॉपर्टी. मास्टर को किसी अतिरिक्त प्रॉपर्टी की ज़रूरत नहीं है. properties इनमें से सिर्फ़ एक हो सकता है:
slideProperties

object (SlideProperties)

स्लाइड से जुड़ी खास प्रॉपर्टी को चुनें. सिर्फ़ तब सेट करें, जब pageType = SLIDE हो.
layoutProperties

object (LayoutProperties)

लेआउट से जुड़ी प्रॉपर्टी. सिर्फ़ तब सेट करें, जब pageType = LAYOUT हो.
notesProperties

object (NotesProperties)

खास प्रॉपर्टी का ध्यान रखता है. सिर्फ़ तब सेट करें, जब pageType = NOTES सेट हो.
masterProperties

object (MasterProperties)

खास प्रॉपर्टी में महारत हासिल करें. सिर्फ़ तब सेट करें, जब pageType = मास्टर हो.

PageType

पेज किस तरह का है.

Enums
SLIDE स्लाइड पेज.
MASTER मास्टर स्लाइड पेज.
LAYOUT लेआउट पेज.
NOTES नोट वाला पेज.
NOTES_MASTER नोट का मास्टर पेज.

PageElement

किसी पेज पर रेंडर किया गया विज़ुअल एलिमेंट.

JSON के काेड में दिखाना 
{
  "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.
}
फ़ील्ड
objectId

string

इस पेज एलिमेंट के लिए ऑब्जेक्ट आईडी. google.apps.slides.v1.Page और google.apps.slides.v1.PageElement, जिन ऑब्जेक्ट आईडी का इस्तेमाल करते हैं उनका नेमस्पेस एक ही होता है.
size

object (Size)

पेज एलिमेंट का साइज़.
transform

object (AffineTransform)

पेज तत्व का रूपांतरण.

पेज एलिमेंट कैसा दिखेगा, यह उसके कुल बदलाव से तय होता है. कुल ट्रांसफ़ॉर्म का पता लगाने के लिए, किसी पेज एलिमेंट के ट्रांसफ़ॉर्म को उसके सभी पैरंट ग्रुप में हुए ट्रांसफ़ॉर्म की वैल्यू से पहले ही शामिल करें. अगर पेज एलिमेंट किसी ग्रुप में नहीं है, तो उसका कुल बदलाव इस फ़ील्ड की वैल्यू के जैसा ही होगा.

नए Group का शुरुआती ट्रांसफ़ॉर्म, हमेशा आइडेंटिटी ट्रांसफ़ॉर्म होता है.
title

string

पेज एलिमेंट का टाइटल. वैकल्पिक लेख दिखाने के लिए, ब्यौरे के साथ जोड़ा गया.

यह फ़ील्ड Group एलिमेंट के साथ काम नहीं करता.
description

string

पेज एलिमेंट के बारे में जानकारी. वैकल्पिक लेख दिखाने के लिए शीर्षक के साथ जोड़ा गया.

यह फ़ील्ड Group एलिमेंट के साथ काम नहीं करता.
यूनियन फ़ील्ड element_kind. यह PageElement किस तरह का एलिमेंट है. हर मैसेज में, उस तरह के पेज एलिमेंट की खास प्रॉपर्टी मौजूद होती हैं. element_kind इनमें से सिर्फ़ एक हो सकता है:
elementGroup

object (Group)

पेज एलिमेंट का कलेक्शन, जो एक यूनिट में जुड़ा होता है.
shape

object (Shape)

सामान्य आकार.
image

object (Image)

इमेज वाले पेज का एलिमेंट.
video

object (Video)

वीडियो पेज एलिमेंट.
line

object (Line)

लाइन वाले पेज का एलिमेंट.
table

object (Table)

टेबल पेज एलिमेंट.
wordArt

object (WordArt)

वर्ड आर्ट पेज एलिमेंट.
sheetsChart

object (SheetsChart)

Google Sheets से एम्बेड किया गया लिंक किया गया चार्ट. अनलिंक किए गए चार्ट, इमेज के तौर पर दिखाए जाते हैं.
speakerSpotlight

object (SpeakerSpotlight)

स्पीकर स्पॉटलाइट.

ग्रुप

यह PageElement टाइप, जो PageElements के जोड़े गए कलेक्शन को दिखाता है.

JSON के काेड में दिखाना 
{
  "children": [
    {
      object (PageElement)
    }
  ]
}
फ़ील्ड
children[]

object (PageElement)

ग्रुप के एलिमेंट का संग्रह. ग्रुप का कम से कम साइज़ दो होना चाहिए.

WordArt

PageElement टाइप, जो वर्ड आर्ट को दिखाता है.

JSON के काेड में दिखाना 
{
  "renderedText": string
}
फ़ील्ड
renderedText

string

वर्ड आर्ट के तौर पर दिखाया गया टेक्स्ट.

SpeakerSpotlight

PageElement टाइप, जो स्पीकर स्पॉटलाइट को दिखाता है.

JSON के काेड में दिखाना 
{
  "speakerSpotlightProperties": {
    object (SpeakerSpotlightProperties)
  }
}
फ़ील्ड
speakerSpotlightProperties

object (SpeakerSpotlightProperties)

स्पीकर स्पॉटलाइट की प्रॉपर्टी.

SpeakerSpotlightProperties

SpeakerSpotlight की प्रॉपर्टी.

JSON के काेड में दिखाना 
{
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  }
}
फ़ील्ड
outline

object (Outline)

स्पीकर स्पॉटलाइट की आउटलाइन की जानकारी. अगर सेट नहीं है, तो इसकी कोई आउटलाइन नहीं होती.
shadow

object (Shadow)

स्पीकर स्पॉटलाइट की परछाई. अगर नीति को सेट नहीं किया जाता है, तो इसकी कोई परछाई नहीं होती है.

SlideProperties

Page की ऐसी प्रॉपर्टी जो सिर्फ़ pageType SLIDE वाले पेजों के लिए काम की हैं.

JSON के काेड में दिखाना 
{
  "layoutObjectId": string,
  "masterObjectId": string,
  "notesPage": {
    object (Page)
  },
  "isSkipped": boolean
}
फ़ील्ड
layoutObjectId

string

उस लेआउट का ऑब्जेक्ट आईडी जिस पर यह स्लाइड आधारित है. इस प्रॉपर्टी को सिर्फ़ पढ़ा जा सकता है.
masterObjectId

string

मास्टर का वह ऑब्जेक्ट आईडी जिस पर यह स्लाइड आधारित है. इस प्रॉपर्टी को सिर्फ़ पढ़ा जा सकता है.
notesPage

object (Page)

नोट का वह पेज जिससे यह स्लाइड जुड़ी है. यह स्लाइड, प्रज़ेंटर के नोट के साथ स्लाइड को प्रिंट या एक्सपोर्ट करते समय, नोट वाले पेज के दिखने के तरीके के बारे में बताता है. नोट वाला पेज, notes master से प्रॉपर्टी इनहेरिट करता है. नोट पेज पर मौजूद प्लेसहोल्डर के आकार में इस स्लाइड के लिए, प्रज़ेंटर के नोट शामिल हैं. इसका टाइप BODY है. इस आकार के आईडी की पहचान, speakerNotesObjectId फ़ील्ड से की जाती है. नोट का पेज सिर्फ़ पढ़ने के लिए होता है. हालांकि, स्पीकर नोट के आकार के टेक्स्ट और स्टाइल वाला कॉन्टेंट नहीं देखा जा सकता. इस प्रॉपर्टी को सिर्फ़ पढ़ा जा सकता है.
isSkipped

boolean

प्रज़ेंटेशन मोड में स्लाइड को स्किप किया जाता है या नहीं. डिफ़ॉल्ट तौर पर, 'गलत' पर सेट होती है.

LayoutProperties

Page की प्रॉपर्टी सिर्फ़ pageType लेआउट वाले पेजों के लिए काम की हैं.

JSON के काेड में दिखाना 
{
  "masterObjectId": string,
  "name": string,
  "displayName": string
}
फ़ील्ड
masterObjectId

string

मास्टर का वह ऑब्जेक्ट आईडी जिस पर यह लेआउट आधारित है.
name

string

लेआउट का नाम.
displayName

string

लेआउट का ऐसा नाम जिसे कोई भी व्यक्ति आसानी से पढ़ सके.

NotesProperties

Page की ऐसी प्रॉपर्टी जो सिर्फ़ pageType NOTES वाले पेजों के लिए काम की हैं.

JSON के काेड में दिखाना 
{
  "speakerNotesObjectId": string
}
फ़ील्ड
speakerNotesObjectId

string

नोट के इस पेज पर मौजूद आकार का ऑब्जेक्ट आईडी, जिसमें इससे जुड़ी स्लाइड के लिए प्रज़ेंटर के नोट शामिल हैं. ज़रूरी नहीं है कि नोट के पेज पर असल आकार हमेशा मौजूद हो. इस ऑब्जेक्ट आईडी का इस्तेमाल करके टेक्स्ट डालने पर, आकार अपने-आप बन जाएगा. इस मामले में, असली आकार का ऑब्जेक्ट आईडी अलग-अलग हो सकता है. presentations.get या pages.get कार्रवाई से हमेशा नया ऑब्जेक्ट आईडी दिखेगा.

MasterProperties

Page की ऐसी प्रॉपर्टी जो सिर्फ़ pageType मास्टर वाले पेजों के लिए काम की हैं.

JSON के काेड में दिखाना 
{
  "displayName": string
}
फ़ील्ड
displayName

string

मास्टर का वह नाम जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.

PageProperties

Page की प्रॉपर्टी.

पेज, पैरंट पेज से प्रॉपर्टी इनहेरिट करेगा. पेज टाइप के आधार पर, हैरारकी को SlideProperties या LayoutProperties में बताया जाता है.

JSON के काेड में दिखाना 
{
  "pageBackgroundFill": {
    object (PageBackgroundFill)
  },
  "colorScheme": {
    object (ColorScheme)
  }
}
फ़ील्ड
pageBackgroundFill

object (PageBackgroundFill)

पेज का बैकग्राउंड में भरने की सुविधा. अगर यह नीति सेट नहीं है, तो पैरंट पेज मौजूद होने पर, बैकग्राउंड में भरने की सुविधा को पैरंट पेज से इनहेरिट किया जाता है. अगर पेज का कोई पैरंट पेज नहीं है, तो Slides के एडिटर में बैकग्राउंड में, फ़िल की सुविधा डिफ़ॉल्ट रूप से उसके हिसाब से फ़िल पर सेट होती है.
colorScheme

object (ColorScheme)

पेज की कलर स्कीम. अगर यह नीति सेट नहीं है, तो कलर स्कीम पैरंट पेज से ली जाती है. अगर किसी पेज का कोई पैरंट पेज नहीं है, तो कलर स्कीम, Slides की डिफ़ॉल्ट कलर स्कीम का इस्तेमाल करती है. यह कलर स्कीम, Slides एडिटर की डिफ़ॉल्ट कलर स्कीम से मेल खाती है.

सिर्फ़ शुरुआती 12 ThemeColorType के कंक्रीट के रंगों में बदलाव किया जा सकता है. इसके अलावा, सिर्फ़ Master पेजों पर कलर स्कीम को अपडेट किया जा सकता है. फ़ील्ड को अपडेट करने के लिए, एक कलर स्कीम देनी होगी जिसमें पहले 12 थीमColorTypes से लेकर उनके कंक्रीट कलर तक मैपिंग शामिल हों. बाकी के थीमColorTypes के रंगों को अनदेखा कर दिया जाएगा.

PageBackgroundFill

पेज का बैकग्राउंड फ़िल.

JSON के काेड में दिखाना 
{
  "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.
}
फ़ील्ड
propertyState

enum (PropertyState)

बैकग्राउंड में भरने वाली प्रॉपर्टी की स्थिति.

किसी पेज पर फ़िल को अपडेट करने से, यह फ़ील्ड साफ़ तौर पर RENDERED में अपडेट हो जाएगा. ऐसा तब तक होगा, जब तक उसी अनुरोध में कोई दूसरी वैल्यू न दी गई हो. पेज पर कोई जानकारी न हो, इसके लिए इस फ़ील्ड को NOT_RENDERED पर सेट करें. इस मामले में, एक ही अनुरोध में सेट किए गए अन्य फ़िल फ़ील्ड को अनदेखा कर दिया जाएगा.
यूनियन फ़ील्ड kind. इसका बैकग्राउंड किस तरह का है. kind इनमें से सिर्फ़ एक हो सकता है:
solidFill

object (SolidFill)

ठोस रंग फ़िल.
stretchedPictureFill

object (StretchedPictureFill)

स्ट्रेच किया गया चित्र फ़िल.

StretchedPictureFill

बढ़ाई गई फ़ोटो में ज़्यादा इफ़ेक्ट नहीं जोड़ा जा सकता. पेज या पेज के एलिमेंट में बताई गई जानकारी दी गई हो. चित्र को उसके कंटेनर में फ़िट करने के लिए फैलाया गया है.

JSON के काेड में दिखाना 
{
  "contentUrl": string,
  "size": {
    object (Size)
  }
}
फ़ील्ड
contentUrl

string

contentUrl पढ़ना:

30 मिनट की डिफ़ॉल्ट लाइफ़टाइम अवधि वाली तस्वीर का यूआरएल. यह यूआरएल, अनुरोध करने वाले के खाते से टैग किया गया है. अगर किसी व्यक्ति के पास यूआरएल है, तो वह इमेज को अनुरोध करने वाले व्यक्ति के तौर पर, असरदार तरीके से ऐक्सेस करता है. अगर प्रज़ेंटेशन की शेयर करने की सेटिंग बदल जाती है, तो हो सकता है कि आप फ़ोटो को ऐक्सेस न कर पाएं.

contentUrl लिखना:

शामिल करने के समय, तस्वीर को फ़ेच किया जाता है. इसके बाद, प्रज़ेंटेशन में दिखाने के लिए एक कॉपी सेव कर ली जाती है. तस्वीरों का साइज़ 50 एमबी से कम होना चाहिए. साथ ही, यह 25 मेगापिक्सल से ज़्यादा की नहीं होनी चाहिए. साथ ही, यह PNG, JPEG या GIF फ़ॉर्मैट में से किसी एक में होना चाहिए.

दिया गया यूआरएल ज़्यादा से ज़्यादा 2 केबी का हो सकता है.
size

object (Size)

चित्र फ़िल का मूल आकार. इस फ़ील्ड को सिर्फ़ पढ़ा जा सकता है.

ColorScheme

यह किसी पेज के लिए, पहले से तय किए गए रंगों का पैलेट होता है.

JSON के काेड में दिखाना 
{
  "colors": [
    {
      object (ThemeColorPair)
    }
  ]
}
फ़ील्ड
colors[]

object (ThemeColorPair)

थीम ColorType और उससे जुड़े कंक्रीट के रंग के पेयर.

ThemeColorPair

थीम के कलर टाइप को उस कंक्रीट के रंग से मैप करता हुआ जोड़ा गया जिसे वह दिखाता है.

JSON के काेड में दिखाना 
{
  "type": enum (ThemeColorType),
  "color": {
    object (RgbColor)
  }
}
फ़ील्ड
type

enum (ThemeColorType)

थीम के रंग का टाइप.
color

object (RgbColor)

ऊपर दिए गए थीम के रंग के हिसाब से कंक्रीट का रंग.

तरीके

get

 प्रज़ेंटेशन में बताए गए पेज का नया वर्शन पाएं.

getThumbnail

 प्रज़ेंटेशन में बताए गए पेज के सबसे नए वर्शन का थंबनेल जनरेट करता है और थंबनेल इमेज का यूआरएल दिखाता है.