مرجع بيان مؤثرات عرض المجتمع

ملاحظة: تتوفّر ميزة "التمثيل البصري للمنتدى" في "معاينة المطوِّر". لمعرفة المزيد من المعلومات عن الميزات والتحسينات القادمة خلال هذه الفترة، انتقِل إلى صفحة معاينة المطوِّر.

يوفر البيان معلومات حول التصور الخاص بك ويحدد موقع موارد التصور الخاصة بك. يجب تسميته manifest.json ووضعه في المستوى الأعلى من المجلد المستخدَم باعتباره Component ID.

يجب تحديد الحقول التالية (ما لم يرد خلاف ذلك):

اسم الحقل	Type	الوصف
name	string	اسم حزمة العروض المرئية.
organization	string	اسم المؤسسة أو المطوّر
description	string	وصف حزمة العروض المرئية.
logoUrl	string	شعار لحزمة العروض المرئية.
packageUrl	string	رابط يمكن للمستخدمين اتباعه لمعرفة المزيد حول الحزمة
organizationUrl	string	(اختياري) رابط يمكن للمستخدمين اتّباعه لمعرفة المزيد من المعلومات عن المؤسسة أو المطوّر.
supportUrl	string	رابط إلى صفحة الدعم أو البريد الإلكتروني لدعم هذا التصور.
privacyPolicyUrl	string	(اختياري) رابط إلى سياسة الخصوصية.
termsOfServiceUrl	string	(اختياري) رابط إلى بنود الخدمة.
devMode	boolean	(اختياري) في حال اختيار القيمة "true"، يتم تخطي التخزين المؤقت. ويتم ضبط هذه القيمة تلقائيًا على false. للمزيد من التفاصيل، يمكنك الاطّلاع على لمحة عن التخزين المؤقت.
components	Array(object)	الرسومات البيانية التي يتم تضمينها في الحزمة. يُسمح في الوقت الحالي بعرض تمثيل بصري واحد فقط..
components[].id	string	رقم تعريف المكوِّن. يجب أن تكون هذه سلسلة غير فارغة بدون مسافات.
components[].name	string	اسم التمثيل البصري.
components[].description	string	تمثّل هذه السمة وصفًا للتمثيل المرئي.
components[].iconUrl	string	أيقونة للتصور.
components[].infoUrl	string	(اختياري) رابط يمكن للمستخدمين اتّباعه لمعرفة المزيد من المعلومات عن المكوِّن.
components[].resource	object	موارد التمثيل البصري
components[].resource.js	string	يشير ذلك المصطلح إلى موقع ملف JavaScript للتمثيل البصري في Google Cloud Storage. مثال: gs://GCS_BUCKET_NAME/MY_VISUALIZATION.js
components[].resource.config	string	موقع ملف إعداد العرض المرئي في Google Cloud Storage مثال: gs://GCS_BUCKET_NAME/MY_CONFIG.json
components[].resource.css	string	(اختياري) موقع ملف CSS للتمثيل البصري في Google Cloud Storage. مثال: gs://GCS_BUCKET_NAME/MY_CSS.css

ملاحظة: يمكن أن يحتوي كل بيان على مكونات متعددة. ويجب أن يكون لكل مكوّن id

فريد

مثال على ملف بيان manifest.json

{
  "name": "ABC Visualizations Package",
  "organization": "ABC Inc.",
  "description": "A package of cool visualizations.",
  "logoUrl": "https://url",
  "organizationUrl": "https://url",
  "supportUrl": "https://url",
  "privacyPolicyUrl": "https://url",
  "termsOfServiceUrl": "https://url",
  "packageUrl": "https://url",
  "devMode": false,
  "components": [
    {
      "id": "treemap",
      "name": "Treemap",
      "description": "Zoomable treemap with filter interactions",
      "iconUrl": "https://url.png",
      "infoUrl": "https://url",
      "resource": {
        "js": "gs://myViz-bucket-treemap/viz.js",
        "config": "gs://myViz-bucket-treemap/viz-config.json",
        "css": "gs://myViz-bucket-treemap/viz.css"
      }
    },
    {
      "id": "histogram",
      "name": "Histogram",
      "description": "Histogram with filter interactions",
      "iconUrl": "https://url.png",
      "resource": {
        "js": "gs://myViz-bucket-histogram/viz.js",
        "config": "gs://myViz-bucket-histogram/viz-config.json",
        "css": "gs://myViz-bucket-histogram/viz.css"
      }
    }
  ]
}