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 = MASTER.

PageType

نوع الصفحة.

عمليات التعداد
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)

عنصر في صفحة Word Art
sheetsChart

object (SheetsChart)

رسم بياني مرتبط تم تضمينه من "جداول بيانات Google" يتم تمثيل الرسوم البيانية غير المرتبطة على شكل صور.
speakerSpotlight

object (SpeakerSpotlight)

تضمين كاميرا المُحاضر

مجموعة

نوع PageElement يمثّل مجموعة مُدمَجة من عناصر الصفحة

تمثيل JSON 
{
  "children": [
    {
      object (PageElement)
    }
  ]
}
الحقول
children[]

object (PageElement)

مجموعة العناصر في المجموعة الحد الأدنى لحجم مجموعة هو 2.

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

ما إذا تم تخطي الشريحة في وضع العرض التقديمي القيمة التلقائية هي false.

LayoutProperties

خصائص Page ملائمة فقط للصفحات التي تحتوي على تنسيق pageType LAYOUT.

تمثيل 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 MASTER

تمثيل JSON 
{
  "displayName": string
}
الحقول
displayName

string

الاسم السهل القراءة للملف الرئيسي

PageProperties

خصائص Page

ستكتسب الصفحة الخصائص من الصفحة الرئيسية. استنادًا إلى نوع الصفحة، يتم تحديد التسلسل الهرمي في SlideProperties أو LayoutProperties.

تمثيل JSON 
{
  "pageBackgroundFill": {
    object (PageBackgroundFill)
  },
  "colorScheme": {
    object (ColorScheme)
  }
}
الحقول
pageBackgroundFill

object (PageBackgroundFill)

تعبئة خلفية الصفحة. في حال عدم ضبطه، يتم اكتساب تعبئة الخلفية من صفحة رئيسية إذا كانت متوفّرة. إذا لم تكن الصفحة لها عنصر رئيسي، يتم ضبط تعبئة الخلفية تلقائيًا على التعبئة المقابلة في محرِّر "العروض التقديمية من Google".
colorScheme

object (ColorScheme)

نظام ألوان الصفحة في حال عدم ضبطه، يتم اكتساب نظام الألوان من صفحة رئيسية. إذا لم تكن الصفحة تحتوي على عنصر رئيسي، يستخدم نظام الألوان نظام ألوان تلقائي في "العروض التقديمية من Google"، مع مطابقة الإعدادات التلقائية في "محرِّر العروض التقديمية".

لا يمكن تعديل سوى الألوان المحدّدة لأول 12 ThemeColorType. بالإضافة إلى ذلك، يمكن تعديل المخطط اللوني في Master صفحة فقط. لتحديث الحقل، يجب توفير نظام ألوان يحتوي على تعيينات من جميع ThemeColorTypes الـ 12 الأولى إلى ألوانها الملموسة. وسيتم تجاهل ألوان ThemeColorTypes المتبقية.

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

قراءة محتوى عنوان URL:

عنوان URL لصورة مع مدة عرض افتراضية تبلغ 30 دقيقة تمّ وضع علامة على عنوان URL هذا بالحساب الخاص بمقدّم الطلب. ويمكن لأي مستخدم لديه عنوان URL الوصول إلى الصورة بصفته مقدِّم الطلب الأصلي. قد يتم فقد إمكانية الوصول إلى الصورة في حالة تغيير إعدادات مشاركة العرض التقديمي.

كتابة contentUrl:

يتم جلب الصورة مرة واحدة في وقت الإدراج ويتم تخزين نسخة منها لعرضها داخل العرض التقديمي. يجب أن يكون حجم الصور أقل من 50 ميغابايت، ولا يمكن أن يتجاوز 25 ميغا بكسل، ويجب أن تكون بتنسيق PNG أو JPEG أو GIF.

يجب ألا يزيد طول عنوان URL المقدَّم عن 2 كيلوبايت.
size

object (Size)

الحجم الأصلي لملء الصورة. هذا الحقل للقراءة فقط.

ColorScheme

لوحة الألوان المحدّدة مسبقًا لصفحة معيّنة

تمثيل JSON 
{
  "colors": [
    {
      object (ThemeColorPair)
    }
  ]
}
الحقول
colors[]

object (ThemeColorPair)

ThemeColorType وزوجات الألوان المحدّدة ذات الصلة

ThemeColorPair

زوج يربط نوع لون المظهر باللون المحدّد الذي يمثّله

تمثيل JSON 
{
  "type": enum (ThemeColorType),
  "color": {
    object (RgbColor)
  }
}
الحقول
type

enum (ThemeColorType)

نوع لون المظهر.
color

object (RgbColor)

اللون الخرساني المقابل لنوع لون المظهر أعلاه.

الطُرق

get

 الحصول على أحدث نسخة من الصفحة المحددة في العرض التقديمي.

getThumbnail

 تُنشئ هذه الدالة صورة مصغّرة لأحدث إصدار من الصفحة المحدّدة في العرض التقديمي، وتُعرِض عنوان URL للصورة المصغّرة.