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"، ما يتطابق مع الإعدادات التلقائية في محرِّر "العروض التقديمية من Google".

لا يمكن تعديل سوى الألوان المحدّدة لأول 12 ThemeColorType. بالإضافة إلى ذلك، يمكن تعديل المخطط اللوني في Master صفحة فقط. لتعديل الحقل، يجب توفير مخطّط ألوان يحتوي على عمليات ربط من كلّ 12 نوعًا أوّل من ThemeColorTypes إلى ألوانها المحدّدة. وسيتم تجاهل ألوان 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 للصورة المصغّرة.