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 = شريحة SIM.
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 يمثّل مجموعة من عناصر الصفحة (PageElements).

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

object (PageElement)

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

WordArt

نوع PageElement يمثّل فن الكلمات.

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

string

يشير ذلك المصطلح إلى النص المعروض على شكل Word Art.

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 LAYOUT.

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

string

رقم تعريف الكائن الرئيسي الذي يستند إليه هذا التنسيق.
name

string

اسم التنسيق.
displayName

string

تمثّل هذه السمة اسم التنسيق الذي يمكن لشخص عادي قراءته.

NotesProperties

سمات Page ذات الصلة فقط بالصفحات التي تتضمّن ملاحظات من نوع pageType

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

string

رقم تعريف العنصر للشكل في صفحة الملاحظات هذه الذي يحتوي على ملاحظات المحاضر في الشريحة المعنية قد لا يكون الشكل الفعلي موجودًا دائمًا في صفحة الملاحظات. سيؤدي إدراج نص باستخدام رقم تعريف الكائن هذا إلى إنشاء الشكل تلقائيًا. في هذه الحالة، قد يحتوي الشكل الفعلي على رقم تعريف عنصر مختلف. سيعرض الإجراء presentations.get أو pages.get دائمًا أحدث رقم تعريف للكائن.

MasterProperties

خصائص Page ذات الصلة فقط بالصفحات التي تتضمّن نوع الصفحة 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

قراءة contentUrl:

عنوان 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 للصورة المصغّرة.