Pivot Tables

{
  "rows": [
    {
      object (PivotGroup)
    }
  ],
  "columns": [
    {
      object (PivotGroup)
    }
  ],
  "criteria": {
    integer: {
      object (PivotFilterCriteria)
    },
    ...
  },
  "filterSpecs": [
    {
      object (PivotFilterSpec)
    }
  ],
  "values": [
    {
      object (PivotValue)
    }
  ],
  "valueLayout": enum (PivotValueLayout),
  "dataExecutionStatus": {
    object (DataExecutionStatus)
  },

  // Union field source_data can be only one of the following:
  "source": {
    object (GridRange)
  },
  "dataSourceId": string
  // End of list of possible types for union field source_data.
}

object (PivotGroup)

كل تجميع صف في الجدول المحوري.

object (PivotGroup)

كل تجميع أعمدة في الجدول المحوري.

map (key: integer, value: object ( PivotFilterCriteria))

تعيين اختياري للفلاتر لكل إزاحة عمود المصدر.

يتم تطبيق عوامل التصفية قبل تجميع البيانات في الجدول المحوري. مفتاح الخريطة هو إزاحة العمود لنطاق المصدر الذي تريد تصفيته، والقيمة هي معايير هذا العمود.

على سبيل المثال، إذا كان المصدر C10:E15، وهو مفتاح 0 على عامل التصفية للعمود C، في حين أن المفتاح 1 هو للعمود D

تم إيقاف هذا الحقل لصالح filterSpecs

object (PivotFilterSpec)

الفلاتر المطبّقة على أعمدة المصدر قبل تجميع البيانات للجدول المحوري

كلاهما criteria أو filterSpecs تتم تعبئتها في الاستجابات. إذا تم تحديد كلا الحقلَين في طلب تعديل، ستكون الأولوية لهذا الحقل.

object (PivotValue)

قائمة بالقيم المطلوب تضمينها في الجدول المحوري.

enum (PivotValueLayout)

لتحديد ما إذا كان يجب إدراج القيم أفقيًا (كأعمدة) أو عموديًا (كصفوف).

object (DataExecutionStatus)

النتائج فقط. حالة تنفيذ البيانات في الجداول المحورية لمصدر البيانات.

object (GridRange)

النطاق الذي يقرأ منه الجدول المحوري البيانات.

string

معرف مصدر البيانات الذي يقوم الجدول المحوري بقراءة البيانات منه.

{
  "showTotals": boolean,
  "valueMetadata": [
    {
      object (PivotGroupValueMetadata)
    }
  ],
  "sortOrder": enum (SortOrder),
  "valueBucket": {
    object (PivotGroupSortValueBucket)
  },
  "repeatHeadings": boolean,
  "label": string,
  "groupRule": {
    object (PivotGroupRule)
  },
  "groupLimit": {
    object (PivotGroupLimit)
  },

  // Union field source can be only one of the following:
  "sourceColumnOffset": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field source.
}

boolean

صحيح إذا كان الجدول المحوري يجب أن يتضمن الإجماليات لهذه التجميع.

object (PivotGroupValueMetadata)

بيانات التعريف حول القيم الموجودة في التجميع.

enum (SortOrder)

يجب فرز القيم في هذه المجموعة.

object (PivotGroupSortValueBucket)

حزمة المجموعة المحورية المعاكسة المطلوب الترتيب حسبها. إذا لم يتم تحديده، فسيتم ترتيب الترتيب أبجديًا حسب قيم هذه المجموعة.

boolean

صحيح إذا كان يجب تكرار العناوين في هذه المجموعة المحورية. يصلح هذا فقط لتجميع الصفوف ويتم تجاهله بواسطة الأعمدة.

بشكل افتراضي، يتم تقليل تكرار العناوين عن طريق عدم عرض عناوين ذات مستوى أعلى عند تطابقها. على سبيل المثال، على الرغم من أن الصف الثالث أدناه يتجاوب مع "الربع الأول من آذار (مارس)"، و"Q1" لأنه متكرر مع الصفوف السابقة. سيؤدي ضبط تكرار العناوين على "صحيح" إلى حدوث "Q1" تكرارًا في "فبراير" و"مارس".

+--------------+
| Q1     | Jan |
|        | Feb |
|        | Mar |
+--------+-----+
| Q1 Total     |
+--------------+

string

التصنيفات المراد استخدامها لمجموعات الصفوف/الأعمدة التي يمكن تخصيصها فعلى سبيل المثال، في الجدول المحوري التالي، تسمية الصف هي Region (والتي يمكن إعادة تسميتها إلى State) وتصنيف العمود هو Product (والتي يمكن إعادة تسميتها Item). لا تحتوي الجداول المحورية التي تم إنشاؤها قبل كانون الأول (ديسمبر) 2017 على تصنيفات عناوين. إذا كنت تريد إضافة تصنيفات العناوين إلى جدول محوري موجود، يُرجى حذف الجدول المحوري الحالي ثم إنشاء جدول محوري جديد باستخدام نفس المعلمات.

+--------------+---------+-------+
| SUM of Units | Product |       |
| Region       | Pen     | Paper |
+--------------+---------+-------+
| New York     |     345 |    98 |
| Oregon       |     234 |   123 |
| Tennessee    |     531 |   415 |
+--------------+---------+-------+
| Grand Total  |    1110 |   636 |
+--------------+---------+-------+

object (PivotGroupRule)

قاعدة المجموعة المطلوب تطبيقها على مجموعة الصفوف/الأعمدة هذه.

object (PivotGroupLimit)

الحد الأقصى لعدد الصفوف أو الأعمدة المطلوب تطبيقه على هذه المجموعة المحورية.

integer

إزاحة العمود لنطاق المصدر الذي يستند إليه هذا التجميع.

على سبيل المثال، إذا كان المصدر C10:E15، sourceColumnOffset من 0 تعني أن هذه المجموعة تشير إلى العمود C، في حين أن الإزاحة 1 سيشير إلى العمود D

object (DataSourceColumnReference)

المرجع إلى عمود مصدر البيانات الذي يستند إليه هذا التجميع.

{
  "value": {
    object (ExtendedValue)
  },
  "collapsed": boolean
}

object (ExtendedValue)

القيمة المحسوبة التي تتوافق معها البيانات الوصفية. (لاحظ أن formulaValue غير صالح، لأنه سيتم حساب القيم.)

boolean

True في حالة تصغير البيانات المقابلة للقيمة.

{
  "valuesIndex": integer,
  "buckets": [
    {
      object (ExtendedValue)
    }
  ]
}

integer

معادلة فرق البيانات PivotTable.values قائمة القيم التي يجب ترتيب القيم في هذه المجموعة وفقًا لها.

object (ExtendedValue)

تحدد مجموعة البيانات التي يتم اختيار القيم منها للترتيب.

على سبيل المثال، في جدول محوري يحتوي على مجموعة صفوف واحدة & مجموعتين من الأعمدة، يمكن لمجموعة الصفوف سرد ما يصل إلى قيمتين. تتجاوب القيمة الأولى مع قيمة داخل مجموعة الأعمدة الأولى، وتتجاوب القيمة الثانية مع قيمة في مجموعة الأعمدة الثانية. إذا لم يتم سرد أي قيم، فهذا يشير إلى أنه يجب فرز الصف وفقًا لـ "الإجمالي الكلي" فوق مجموعات الأعمدة. وإذا تم إدراج قيمة واحدة، فإن هذا يتوافق مع استخدام عمود "الإجمالي" من هذه المجموعة.

{

  // Union field rule can be only one of the following:
  "manualRule": {
    object (ManualRule)
  },
  "histogramRule": {
    object (HistogramRule)
  },
  "dateTimeRule": {
    object (DateTimeRule)
  }
  // End of list of possible types for union field rule.
}

object (ManualRule)

حاسمة ManualRule

object (HistogramRule)

حاسمة HistogramRule

object (DateTimeRule)

حاسمة DateTimeRule

{
  "groups": [
    {
      object (ManualRuleGroup)
    }
  ]
}

object (ManualRuleGroup)

قائمة أسماء المجموعات والعناصر المقابلة من بيانات المصدر التي يتم ربطها باسم كل مجموعة.

{
  "groupName": {
    object (ExtendedValue)
  },
  "items": [
    {
      object (ExtendedValue)
    }
  ]
}

object (ExtendedValue)

اسم المجموعة، والذي يجب أن يكون سلسلة. كل مجموعة في مجموعة ManualRule يجب أن يكون اسم المجموعة فريدًا.

object (ExtendedValue)

العناصر المتوفّرة في بيانات المصدر التي يجب وضعها في هذه المجموعة قد يكون كل عنصر سلسلة أو رقمًا أو قيمة منطقية. لا يمكن أن تظهر العناصر في أكثر من مجموعة واحدة داخل مجموعة محدّدة. ManualRule وستظهر العناصر التي لا تظهر في أي مجموعة تلقائيًا.

{
  "interval": number,
  "start": number,
  "end": number
}

number

حجم الحِزم التي يتم إنشاؤها. يجب أن تكون موجبة.

number

يشير ذلك المصطلح إلى القيمة الصغرى التي يتم عندها وضع العناصر في مجموعات ذات حجم ثابت. يتم تجميع القيم أسفل البداية في مجموعة واحدة. هذا الحقل اختياري.

number

الحد الأقصى للقيمة التي يتم عندها وضع العناصر في مجموعات ذات حجم ثابت. يتم تجميع القيم فوق النهاية في مجموعة واحدة. هذا الحقل اختياري.

{
  "type": enum (DateTimeRuleType)
}

enum (DateTimeRuleType)

نوع تجميع التاريخ والوقت المطلوب تطبيقه.

{
  "countLimit": integer,
  "applyOrder": integer
}

integer

الحد الأقصى للعدد.

integer

ترتيب تطبيق الحد الأقصى للمجموعة على الجدول المحوري

يتم تطبيق حدود المجموعات المحورية من رقم الطلب الأدنى إلى الأعلى. تتم تسوية أرقام الطلبات إلى الأعداد الصحيحة المتتالية من 0.

بالنسبة إلى طلب الكتابة، لتخصيص الطلبات المطبَّقة بالكامل، يجب ضبط هذا الحقل على رقم فريد في جميع حدود المجموعات المحورية. وإلا، يتم تحديد الترتيب عن طريق الفهرس في PivotTable.rows قائمة ثم PivotTable.columns الحالية.

{
  "visibleValues": [
    string
  ],
  "condition": {
    object (BooleanCondition)
  },
  "visibleByDefault": boolean
}

string

القيم التي يجب تضمينها. ويتم استبعاد القيم غير المدرَجة هنا.

object (BooleanCondition)

شرط يجب أن يكون صحيحًا حتى يتم عرض القيم. ( visibleValues لا يلغي ذلك -- حتى إذا كانت القيمة مدرجة هناك، فستظل مخفية إذا لم تستوف الشرط).

يتم تقييم قيم الشروط التي تشير إلى النطاقات في الترميز A1 بالنسبة إلى ورقة الجدول المحوري. يتم التعامل مع المراجع بشكل مطلق، لذلك لا يتم ملؤها في الجدول المحوري. على سبيل المثال، قيمة الشرط =A1 على "الجدول المحوري 1" يتم التعامل معه على أنه 'Pivot Table 1'!$A$1

يمكن الإشارة إلى بيانات المصدر للجدول المحوري من خلال اسم رأس العمود. على سبيل المثال، إذا كانت بيانات المصدر تحتوي على أعمدة باسم "الأرباح" و"التكلفة" ويتم تطبيق شرط على عمود "الأرباح" عمود مع النوع NUMBER_GREATER وقيمة =Cost، ثم الأعمدة التي تحتوي فقط على "الأرباح" > "التكلفة" .

boolean

تحديد ما إذا كانت القيم مرئية تلقائيًا إذا كانت القيمة true، visibleValues يتم تجاهلها، ويتم تجاهل جميع القيم التي تفي condition (إذا تم تحديدها). إذا كانت false، فإن القيمتين كلاهما في visibleValues واجتماع condition المعروضة.

{
  "filterCriteria": {
    object (PivotFilterCriteria)
  },

  // Union field source can be only one of the following:
  "columnOffsetIndex": integer,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field source.
}

object (PivotFilterCriteria)

معايير العمود.

integer

إزاحة العمود القائمة على صفر للنطاق المصدر.

object (DataSourceColumnReference)

يشير إلى المرجع إلى عمود مصدر البيانات.

{
  "summarizeFunction": enum (PivotValueSummarizeFunction),
  "name": string,
  "calculatedDisplayType": enum (PivotValueCalculatedDisplayType),

  // Union field value can be only one of the following:
  "sourceColumnOffset": integer,
  "formula": string,
  "dataSourceColumnReference": {
    object (DataSourceColumnReference)
  }
  // End of list of possible types for union field value.
}

enum (PivotValueSummarizeFunction)

دالة لتلخيص القيمة. في حال حذف formula ما تم تحديده، فالقيم المسموح بها فقط هي SUM أو CUSTOM في حال حذف sourceColumnOffset البيانات، ثم CUSTOM غير متاح.

string

اسم لاستخدامه للقيمة.

enum (PivotValueCalculatedDisplayType)

إذا تم تحديدها، فإنها تشير إلى أنه يجب عرض القيم المحورية كنتيجة لعملية حسابية بقيمة محورية أخرى. على سبيل المثال، إذا تم تحديد AdjustDisplayType كنسبة PERCENT_OF_GRAND_TOTAL، يتمّ عرض جميع القيم المحورية كنسبة مئوية من الإجمالي الكلي. في محرر "جداول بيانات Google"، يُشار إلى ذلك باسم "Show as" في قسم القيمة في الجدول المحوري.

integer

إزاحة العمود لنطاق المصدر الذي تقرأ منه هذه القيمة.

على سبيل المثال، إذا كان المصدر C10:E15، sourceColumnOffset من 0 تعني أن هذه القيمة تشير إلى العمود C، في حين أن الإزاحة 1 سيشير إلى العمود D

string

صيغة مخصّصة لحساب القيمة. يجب أن تبدأ المعادلة = الحرف.

object (DataSourceColumnReference)

يشير إلى المرجع إلى عمود مصدر البيانات الذي تتم قراءة هذه القيمة منه.