توضح هذه الصفحة كيفية أخذ المخططات الحالية من "جداول بيانات Google" وإضافتها إلى العروض التقديمية في "العروض التقديمية من Google".
يمكن أن تساعد إضافة المخططات إلى عرض تقديمي في إحداث المزيد من التأثير وجعل البيانات ذات مغزى لجمهورك. تعد المخططات أدوات قوية بشكل فريد لإظهار الأنماط أو الاتجاهات في مجموعة بيانات، ويمكن أن تساعدك في التواصل بوضوح حول البيانات الكمية.
يناقش الفيديو أعلاه كيفية إنشاء شرائح من بيانات جدول البيانات. ويتضمن مثالاً كاملاً (Python) يضيف مخططًا إلى شريحة، ويستورد أيضًا بيانات خلية جدول البيانات إلى جدول.
لمحة عن إضافة الرسوم البيانية
عندما تقدم معلومات كَمية، يمكن لمخططات البيانات تحسين عرضك التقديمي. تتيح لك واجهة برمجة تطبيقات العروض التقديمية تضمين أي مخطط يمكنك إنشاؤه في جداول بيانات Google: المخططات الشريطية والمخططات الخطية والمخططات الدائرية وغيرها.
كما هو موضح في الرسم التخطيطي أعلاه، يجب عليك أولاً إنشاء المخطط في جداول بيانات Google. بمجرد وجود المخطط، يمكنك تضمينه في العرض التقديمي.
العملية العامة لإدارة المخططات في العرض التقديمي هي:
- إنشاء مخطط في جداول بيانات Google.
- استخدِم واجهة برمجة التطبيقات Sheets API لقراءة رقم تعريف الرسم البياني EmbeddedChart الناتج.
- استخدم CreateSheetsChartRequest مرة واحدة لإضافتها إلى شريحة.
- استخدِم RefreshSheetsChartRequest حسب الحاجة لمزامنته مع البيانات المصدر.
الرسوم البيانية الثابتة مقابل الرسوم البيانية المرتبطة
عند استخدام واجهة برمجة التطبيقات لإضافة رسم بياني إلى العرض التقديمي، تكون المعلَمة LinkingMode هي المعلَمة التي تحدّدها. يحدد هذا ما إذا كان ستتم إضافة الرسم البياني كصورة ثابتة أو ككائن يمكن تحديثه في المستقبل.
يمكنك استخدام وضع "LINKED
" في الحالات التالية:
- تريد تحديث المخطط في المستقبل، مما يعكس التغييرات في البيانات الأساسية.
- تريد أن يكون لدى المتعاونين رابط إلى جدول البيانات الذي يحتوي على المخطط المصدر.
يمكنك استخدام الوضع NOT_LINKED_IMAGE
(الثابت):
- أنت تريد ألا يتغير الرسم البياني في المستقبل أبدًا.
- وأنت لا تريد أن يرى المتعاونون رابطًا يؤدي إلى جدول البيانات المصدر.
نطاقات الوصول إلى "جداول بيانات Google"
عند إضافة رسم بياني إلى شريحتك، تحتاج واجهة برمجة تطبيقات "العروض التقديمية من Google" إلى الوصول إليه في "جداول بيانات Google". وهذا يعني أن طلبك يجب أن يستخدم أحد النطاقات التالية:
https://www.googleapis.com/auth/spreadsheets.readonly
(مفضّل)https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive
من الأفضل استخدام نطاق spreadsheets.readonly
بشكل عام، لأنّه
الأكثر تقييدًا. ومع ذلك، إذا كان تطبيقك يستخدم بالفعل أحد النطاقات
الأخرى المذكورة أعلاه، فما عليك سوى استخدام هذا النطاق.
إضافة مخطط
لإضافة مخطط، ستحتاج إلى معرفة رقم تعريف جدول البيانات ورقم تعريف المخطط للمخطط في جداول بيانات Google. بعد ذلك، عليك استدعاء الطريقة batchUpdate
باستخدام
CreateSheetsChartRequest
مرة واحدة لإضافة الرسم البياني.
يأخذ المثال التالي رسمًا بيانيًا ويضيفه إلى شريحة باسم LINKED
بحيث
يمكن إعادة تحميله لاحقًا.
برمجة تطبيقات
البدء
Java
JavaScript
Node.js
PHP
Python
Ruby
إعادة تحميل رسم بياني
إذا ضمّنت رسمًا بيانيًا LINKED
في العرض التقديمي، يمكنك إعادة تحميله
في أي وقت باستخدام
RefreshSheetsChartRequest.
يؤدي هذا إلى تحديث المخطط لجعله متزامنًا مع مخطط جداول البيانات الأساسي
والبيانات التي يستند إليها.
يؤدي المثال التالي إلى تحديث رسم بياني حالي: