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)

السمات الخاصة بـ Notes لا يتم الضبط إلا إذا كان 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 نوع العنصر الذي يمثله عنصر الصفحة هذا. تحتوي كل رسالة على أي خصائص خاصة بهذا النوع من عناصر الصفحة. يمكن أن يكون الحقل "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 يمثّل مجموعة مرتبطة من عناصر PageElement.

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

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