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

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

object (PivotGroupValueMetadata)

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

enum (SortOrder)

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

object (PivotGroupSortValueBucket)

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

boolean

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

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

+--------------+
| 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)

A ManualRule.

object (HistogramRule)

A HistogramRule.

object (DateTimeRule)

A 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)

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

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

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

boolean

ما إذا كانت القيم مرئية تلقائيًا إذا كانت القيمة true، يتم تجاهل visibleValues، ويتم عرض جميع القيم التي تستوفي condition (في حال تحديدها). إذا كانت القيمة "خطأ"، يتم عرض القيم المضمّنة في 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)

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

integer

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

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

string

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

object (DataSourceColumnReference)

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