PivotTable
جدول محوري
تمثيل JSON |
---|
{ "rows": [ { object ( |
الحقول | |
---|---|
rows[]
|
كلّ مجموعة صفوف في الجدول المحوري |
columns[]
|
كل مجموعة أعمدة في الجدول المحوري |
criteria
|
تعيين اختياري للفلاتر لكلّ إزاحة عمود مصدر يتم تطبيق الفلاتر قبل تجميع البيانات في الجدول المحوري. مفتاح الخريطة هو الإزاحة العمودية لعمود النطاق المصدر الذي تريد فلترته، والقيمة هي معايير هذا العمود.
على سبيل المثال، إذا كان المصدر هو
تم إيقاف هذا الحقل نهائيًا واستبداله بحقل
|
filterSpecs[]
|
الفلاتر المطبّقة على أعمدة المصدر قبل تجميع البيانات للجدول المحوري
تتم تعبئة كل من
|
values[]
|
قائمة بالقيم المطلوب تضمينها في الجدول المحوري |
valueLayout
|
ما إذا كان يجب إدراج القيم أفقيًا (كأعمدة) أو عموديًا (كصفوف). |
dataExecutionStatus
|
النتائج فقط. حالة تنفيذ البيانات للجداول المحورية لمصدر البيانات |
حقل الربط
source_data . مصدر بيانات الجدول المحوري
source_data
يمكن أن تكون إحدى القيم التالية فقط:
|
|
source
|
النطاق الذي يقرأ الجدول المحوري البيانات منه. |
dataSourceId
|
رقم تعريف مصدر البيانات الذي يقرأ الجدول المحوري البيانات منه. |
PivotGroup
مجموعة واحدة (إما صف أو عمود) في جدول محوري
تمثيل JSON |
---|
{ "showTotals": boolean, "valueMetadata": [ { object ( |
الحقول | |
---|---|
showTotals
|
صحيح إذا كان يجب أن يتضمّن الجدول المحوري القيم الإجمالية لهذه المجموعة. |
valueMetadata[]
|
البيانات الوصفية حول القيم في المجموعة |
sortOrder
|
ترتيب القيم في هذه المجموعة |
valueBucket
|
مجموعة المجموعة المحورية المعاكسة التي يتم الترتيب حسبها. في حال عدم تحديدها، يتم الترتيب أبجديًا حسب قيم هذه المجموعة. |
repeatHeadings
|
صحيح إذا كان يجب تكرار العناوين في مجموعة Pivot هذه. لا يسري ذلك إلا على تجميعات الصفوف، ويتم تجاهله في الأعمدة. بشكلٍ تلقائي، نحدّ من تكرار العناوين من خلال عدم عرض العناوين ذات المستوى الأعلى التي تتطابق مع بعضها. على سبيل المثال، على الرغم من أنّ الصف الثالث أدناه يتوافق مع "الربع الأول من آذار (مارس)"، لا يتم عرض "الربع الأول" لأنّه متكرّر في الصفوف السابقة. سيؤدي ضبط repeatHeadings على true إلى تكرار "الربع الأول" لشهرَي شباط (فبراير) وآذار (مارس).
|
label
|
التصنيفات التي سيتم استخدامها لمجموعات الصفوف أو الأعمدة والتي يمكن تخصيصها على سبيل المثال، في الجدول المحوري التالي، يكون تصنيف الصف هو
|
groupRule
|
قاعدة المجموعة التي سيتم تطبيقها على مجموعة الصفوف أو الأعمدة هذه. |
groupLimit
|
الحد الأقصى لعدد الصفوف أو الأعمدة المطلوب تطبيقه على مجموعة الجدول المحوري هذه |
حقل الربط
source . مصدر بيانات المجموعة المحورية.
source
يمكن أن تكون إحدى القيم التالية فقط:
|
|
sourceColumnOffset
|
الإزاحة العمودية لعمود النطاق المصدر الذي تستند إليه هذه المجموعة.
على سبيل المثال، إذا كان المصدر هو
|
dataSourceColumnReference
|
إشارة إلى عمود مصدر البيانات الذي تستند إليه هذه المجموعة. |
PivotGroupValueMetadata
بيانات التعريف عن قيمة في مجموعة محورية
تمثيل JSON |
---|
{
"value": {
object ( |
الحقول | |
---|---|
value
|
القيمة المحسوبة التي تتوافق معها البيانات الوصفية (يُرجى العِلم أنّ القيمة
|
collapsed
|
صحيح إذا تم تصغير البيانات المقابلة للقيمة. |
PivotGroupSortValueBucket
معلومات عن القيم التي يجب استخدامها في مجموعة محورية للترتيب
تمثيل JSON |
---|
{
"valuesIndex": integer,
"buckets": [
{
object ( |
الحقول | |
---|---|
valuesIndex
|
الإزاحة في قائمة
|
buckets[]
|
تحدِّد الحزمة التي يتم اختيار القيم منها للترتيب. على سبيل المثال، في جدول محوري يتضمّن مجموعة صفوف واحدة ومجموعة عمودَين، يمكن أن تسرد مجموعة الصفوف ما يصل إلى قيمتَين. تتطابق القيمة الأولى مع قيمة ضمن مجموعة الأعمدة الأولى، وتتطابق القيمة الثانية مع قيمة في مجموعة الأعمدة الثانية. في حال عدم إدراج أي قيم، يعني ذلك أنّه يجب ترتيب الصف وفقًا "للإجمالي العام" على مستوى مجموعات الأعمدة. في حال إدراج قيمة واحدة، سيؤدي ذلك إلى استخدام "الإجمالي" لهذه المجموعة. |
PivotGroupRule
إعداد اختياري في
PivotGroup
يحدِّد مجموعات للقيم في عمود البيانات المصدر بدلاً من تقسيم كل قيمة فردية. يمكن إضافة ملف واحد فقط من نوع
PivotGroup
يتضمّن قاعدة مجموعة لكل عمود في البيانات المصدر، ولكن في أي عمود معيّن، يمكنك إضافة كلّ من
PivotGroup
يتضمّن قاعدة وملف
PivotGroup
لا يتضمّن قاعدة.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الربط
rule . القاعدة التي سيتم تطبيقها على
PivotGroup .
rule
يمكن أن تكون إحدى القيم التالية فقط:
|
|
manualRule
|
أ
|
histogramRule
|
|
dateTimeRule
|
أ
|
ManualRule
يتيح لك تنظيم القيم يدويًا في عمود بيانات المصدر إلى حِزم بأسماء من اختيارك. على سبيل المثال، جدول محوري يجمع عدد السكان حسب الولاية:
+-------+-------------------+
| State | SUM of Population |
+-------+-------------------+
| AK | 0.7 |
| AL | 4.8 |
| AR | 2.9 |
...
+-------+-------------------+
يمكن تحويلها إلى جدول محوري يجمع عدد السكان حسب المنطقة الزمنية من خلال تقديم قائمة بالمجموعات (على سبيل المثال، groupName = 'Central'، items = ['AL'، 'AR'، 'IA'، ...]) إلى قاعدة مجموعة يدوية. يُرجى العِلم أنّه يمكن تحقيق تأثير مشابه من خلال إضافة عمود منطقة زمنية إلى بيانات المصدر وتعديل الجدول المحوري.
+-----------+-------------------+
| Time Zone | SUM of Population |
+-----------+-------------------+
| Central | 106.3 |
| Eastern | 151.9 |
| Mountain | 17.4 |
...
+-----------+-------------------+
تمثيل JSON |
---|
{
"groups": [
{
object ( |
الحقول | |
---|---|
groups[]
|
قائمة بأسماء المجموعات والعناصر المقابلة لها من بيانات المصدر التي ترتبط بكل اسم مجموعة |
ManualRuleGroup
اسم مجموعة وقائمة بالعناصر من بيانات المصدر التي يجب وضعها في المجموعة التي تحمل هذا الاسم
تمثيل JSON |
---|
{ "groupName": { object ( |
الحقول | |
---|---|
groupName
|
اسم المجموعة، الذي يجب أن يكون سلسلة. يجب أن يكون لكل مجموعة في
|
items[]
|
العناصر في بيانات المصدر التي يجب وضعها في هذه المجموعة قد يكون كل عنصر سلسلة أو رقمًا أو قيمة منطقية. يمكن أن تظهر العناصر في مجموعة واحدة كحد أقصى ضمن
|
HistogramRule
تسمح لك بتنظيم القيم الرقمية في عمود بيانات المصدر إلى حِزم بحجم ثابت. يتم وضع كل القيم من
HistogramRule.start
إلى
HistogramRule.end
في مجموعات بحجم
HistogramRule.interval
. بالإضافة إلى ذلك، يتم وضع جميع القيم التي تقل عن
HistogramRule.start
في مجموعة واحدة، ويتم وضع جميع القيم التي تزيد عن
HistogramRule.end
في مجموعة أخرى. يجب تقديم قيمة
HistogramRule.interval
فقط، ولكن في حال تقديم قيمة
HistogramRule.start
و
HistogramRule.end
معًا، يجب أن تكون قيمة
HistogramRule.start
أقل من
HistogramRule.end
. على سبيل المثال، جدول محوري يعرض متوسط مبلغ الشراء حسب العمر ويتضمّن أكثر من 50 صفًا:
+-----+-------------------+
| Age | AVERAGE of Amount |
+-----+-------------------+
| 16 | $27.13 |
| 17 | $5.24 |
| 18 | $20.15 |
...
+-----+-------------------+
يمكن تحويله إلى جدول محوري يشبه الجدول أدناه من خلال تطبيق قاعدة مجموعة للرسم البياني المدرّج مع
HistogramRule.start
25 و
HistogramRule.interval
20 و
HistogramRule.end
65.
+-------------+-------------------+
| Grouped Age | AVERAGE of Amount |
+-------------+-------------------+
| < 25 | $19.34 |
| 25-45 | $31.43 |
| 45-65 | $35.87 |
| > 65 | $27.55 |
+-------------+-------------------+
| Grand Total | $29.12 |
+-------------+-------------------+
تمثيل JSON |
---|
{ "interval": number, "start": number, "end": number } |
الحقول | |
---|---|
interval
|
حجم الحِزم التي يتم إنشاؤها. يجب أن تكون موجبة. |
start
|
الحد الأدنى للقيمة التي يتم عندها وضع العناصر في حِزم بحجم ثابت. يتم تجميع القيم التي تقل عن القيمة البدء في مجموعة واحدة. هذا الحقل اختياري. |
end
|
الحد الأقصى للقيمة التي يتم عندها وضع العناصر في حِزم بحجم ثابت. يتم تجميع القيم فوق النهاية في مجموعة واحدة. هذا الحقل اختياري. |
DateTimeRule
يتيح لك تنظيم قيم التاريخ والوقت في عمود بيانات المصدر في مجموعات استنادًا إلى أجزاء محدّدة من قيم التاريخ أو الوقت. على سبيل المثال، نأخذ جدولاً محوريًا يعرض معاملات المبيعات حسب التاريخ:
+----------+--------------+
| Date | SUM of Sales |
+----------+--------------+
| 1/1/2017 | $621.14 |
| 2/3/2017 | $708.84 |
| 5/8/2017 | $326.84 |
...
+----------+--------------+
يؤدي تطبيق قاعدة مجموعة التاريخ والوقت باستخدام
DateTimeRuleType
من YEAR_MONTH إلى ظهور الجدول المحوري التالي.
+--------------+--------------+
| Grouped Date | SUM of Sales |
+--------------+--------------+
| 2017-Jan | $53,731.78 |
| 2017-Feb | $83,475.32 |
| 2017-Mar | $94,385.05 |
...
+--------------+--------------+
تمثيل JSON |
---|
{
"type": enum ( |
الحقول | |
---|---|
type
|
نوع تجميع التاريخ والوقت المطلوب تطبيقه |
DateTimeRuleType
الأنواع المتاحة لقواعد تجميع التاريخ والوقت تفترض هذه المستندات أنّ لغة جدول البيانات هي "الإنجليزية (الولايات المتحدة)"، على الرغم من أنّ العرض الفعلي للتواريخ والأوقات يستخدم لغة جدول البيانات لبعض أنواع القواعد.
عمليات التعداد | |
---|---|
DATE_TIME_RULE_TYPE_UNSPECIFIED
|
النوع التلقائي، لا تستخدِمه. |
SECOND
|
تجميع التواريخ حسب الثانية، من 0 إلى 59 |
MINUTE
|
تجميع التواريخ حسب الدقيقة، من 0 إلى 59 |
HOUR
|
يمكنك تجميع التواريخ حسب الساعة باستخدام نظام 24 ساعة، من 0 إلى 23. |
HOUR_MINUTE
|
تجميع التواريخ حسب الساعة والدقيقة باستخدام نظام 24 ساعة، على سبيل المثال 19:45 |
HOUR_MINUTE_AMPM
|
تجميع التواريخ حسب الساعة والدقيقة باستخدام نظام 12 ساعة، على سبيل المثال 7:45 مساءً تتم ترجمة رمزَي AM/PM استنادًا إلى لغة جدول البيانات. |
DAY_OF_WEEK
|
تجميع التواريخ حسب يوم الأسبوع، مثلاً الأحد ستتم ترجمة أيام الأسبوع استنادًا إلى لغة جدول البيانات. |
DAY_OF_YEAR
|
تجميع التواريخ حسب اليوم من السنة، من 1 إلى 366 تجدر الإشارة إلى أنّ التواريخ التي تلي 29 شباط (فبراير) تندرج ضمن مجموعات مختلفة في السنوات الكبيسة مقارنةً بالسنوات غير الكبيسة. |
DAY_OF_MONTH
|
تجميع التواريخ حسب اليوم من الشهر، من 1 إلى 31 |
DAY_MONTH
|
تجميع التواريخ حسب اليوم والشهر، على سبيل المثال 22 تشرين الثاني (نوفمبر). تتم ترجمة الشهر استنادًا إلى لغة جدول البيانات. |
MONTH
|
تجميع التواريخ حسب الشهر، مثلاً تشرين الثاني (نوفمبر). تتم ترجمة الشهر استنادًا إلى لغة جدول البيانات. |
QUARTER
|
يمكنك تجميع التواريخ حسب ربع السنة، على سبيل المثال ربع السنة الأول (الذي يمثّل الفترة من كانون الثاني/يناير إلى آذار/مارس). |
YEAR
|
تجميع التواريخ حسب السنة، مثلاً 2008 |
YEAR_MONTH
|
تجميع التواريخ حسب السنة والشهر، على سبيل المثال 2008-تشرين الثاني (نوفمبر). تتم ترجمة الشهر استنادًا إلى لغة جدول البيانات. |
YEAR_QUARTER
|
تجميع التواريخ حسب السنة والربع السنوي، على سبيل المثال الربع الرابع من عام 2008 |
YEAR_MONTH_DAY
|
تجميع التواريخ حسب السنة والشهر واليوم، على سبيل المثال 22-11-2008 |
PivotGroupLimit
الحد الأقصى لعدد الصفوف أو الأعمدة في المجموعة المحورية
تمثيل JSON |
---|
{ "countLimit": integer, "applyOrder": integer } |
الحقول | |
---|---|
countLimit
|
الحدّ الأقصى لعدد العناصر |
applyOrder
|
ترتيب تطبيق الحدّ الأقصى للمجموعة على الجدول المحوري يتم تطبيق حدود المجموعة المحورية من الرقم الأدنى إلى الرقم الأعلى. يتم توحيد أرقام الطلبات إلى أعداد صحيحة متتالية تبدأ من 0.
بالنسبة إلى طلب الكتابة، لتخصيص الطلبات المُطبَّقة بالكامل، يجب ضبط هذا الحقل بقيمة رقم فريد في جميع حدود المجموعات المحورية. بخلاف ذلك، يتم تحديد الترتيب حسب الفهرس في قائمة
|
PivotFilterCriteria
معايير عرض/إخفاء الصفوف في جدول محوري
تمثيل JSON |
---|
{
"visibleValues": [
string
],
"condition": {
object ( |
الحقول | |
---|---|
visibleValues[]
|
القيم التي يجب تضمينها ويتم استبعاد القيم غير المدرَجة هنا. |
condition
|
شرط يجب أن يكون صحيحًا لعرض القيم. (
يتم تقييم قيم الشروط التي تشير إلى نطاقات في تنسيق A1 بالنسبة إلى ورقة الجدول المحوري. تتم معالجة الإحالات بشكل مطلق، لذا لا تتم تعبئتها في أسفل الجدول المحوري. على سبيل المثال، يتم التعامل مع قيمة الشرط
يمكن الإشارة إلى بيانات مصدر الجدول المحوري من خلال اسم عنوان العمود. على سبيل المثال، إذا كانت البيانات المصدر تتضمّن عمودَين باسمَي "الأرباح" و "التكلفة" وتم تطبيق شرط على عمود "الأرباح" من النوع
|
visibleByDefault
|
ما إذا كانت القيم مرئية تلقائيًا إذا كانت القيمة صحيحة، يتم تجاهل
|
PivotFilterSpec
معايير فلترة الجدول المحوري المرتبطة بقيمة متغيّرة في عمود مصدر معيّن
تمثيل JSON |
---|
{ "filterCriteria": { object ( |
الحقول | |
---|---|
filterCriteria
|
معايير العمود |
حقل الربط
source . عمود المصدر الذي ينطبق عليه هذا الفلتر
source
يمكن أن تكون إحدى القيم التالية فقط:
|
|
columnOffsetIndex
|
إزاحة العمود المستندة إلى الصفر لنطاق المصدر |
dataSourceColumnReference
|
إشارة إلى عمود مصدر البيانات |
PivotValue
تعريف كيفية احتساب قيمة في جدول محوري
تمثيل JSON |
---|
{ "summarizeFunction": enum ( |
الحقول | |
---|---|
summarizeFunction
|
دالة لتلخيص القيمة في حال ضبط
|
name
|
اسم لاستخدامه مع القيمة |
calculatedDisplayType
|
في حال تحديدها، تشير إلى أنّه يجب عرض قيم الجدول المحوري كنتيجة عملية حسابية باستخدام قيمة جدول محوري أخرى. على سبيل المثال، إذا تم تحديد calculatedDisplayType على أنّه PERCENT_OF_GRAND_TOTAL، يتم عرض جميع قيم جدول Pivot كنسبة مئوية من الإجمالي العام. في محرِّر "جداول بيانات Google"، يُشار إلى ذلك باسم "العرض على النحو التالي" في قسم القيمة في الجدول المحوري. |
حقل الربط
value . البيانات التي سيتم استخدامها للقيم في الجدول المحوري يجب ضبط قيمة واحدة بالضبط.
value
يمكن أن تكون إحدى القيم التالية فقط:
|
|
sourceColumnOffset
|
إزاحة العمود لنطاق المصدر الذي تقرأ هذه القيمة منه.
على سبيل المثال، إذا كان المصدر
|
formula
|
صيغة مخصّصة لاحتساب القيمة يجب أن تبدأ الصيغة بالحرف
|
dataSourceColumnReference
|
يشير ذلك إلى عمود مصدر البيانات الذي تقرأ هذه القيمة منه. |
PivotValueSummarizeFunction
دالة لتلخيص قيمة محورية
عمليات التعداد | |
---|---|
PIVOT_STANDARD_VALUE_FUNCTION_UNSPECIFIED
|
القيمة التلقائية، لا تستخدمها. |
SUM
|
تتوافق مع الدالة
SUM .
|
COUNTA
|
تتوافق مع الدالة
COUNTA .
|
COUNT
|
تتوافق مع الدالة
COUNT .
|
COUNTUNIQUE
|
تتوافق مع الدالة
COUNTUNIQUE .
|
AVERAGE
|
تتوافق مع الدالة
AVERAGE .
|
MAX
|
تتوافق مع الدالة
MAX .
|
MIN
|
تتوافق مع الدالة
MIN .
|
MEDIAN
|
تتوافق مع الدالة
MEDIAN .
|
PRODUCT
|
تتوافق مع الدالة
PRODUCT .
|
STDEV
|
تتوافق مع الدالة
STDEV .
|
STDEVP
|
تتوافق مع الدالة
STDEVP .
|
VAR
|
تتوافق مع الدالة
VAR .
|
VARP
|
تتوافق مع الدالة
VARP .
|
CUSTOM
|
يشير إلى أنّه يجب استخدام الصيغة كما هي. ولا يكون صالحًا إلا إذا تم ضبط
PivotValue.formula .
|
NONE
|
يشير ذلك إلى أنّه سبق تلخيص القيمة، ولم يتم تحديد دالة التلخيص صراحةً. تُستخدَم للجداول المحورية لمصدر بيانات Looker التي سبق تلخيص قيمتها. |
PivotValueCalculatedDisplayType
الطرق المحتمَلة لاحتساب القيم المحورية لعرضها
عمليات التعداد | |
---|---|
PIVOT_VALUE_CALCULATED_DISPLAY_TYPE_UNSPECIFIED
|
القيمة التلقائية، لا تستخدمها. |
PERCENT_OF_ROW_TOTAL
|
تعرِض هذه السمة قيم الجدول المحوري كنسبة مئوية من قيم إجمالي الصفوف. |
PERCENT_OF_COLUMN_TOTAL
|
تعرِض هذه السمة القيم المحورية كنسبة مئوية من إجمالي قيم الأعمدة. |
PERCENT_OF_GRAND_TOTAL
|
تعرِض هذه السمة قيم جدول Pivot كنسبة مئوية من قيم الإجمالي العام. |
PivotValueLayout
تنسيق القيم المحورية
عمليات التعداد | |
---|---|
HORIZONTAL
|
يتم عرض القيم أفقيًا (كأعمدة). |
VERTICAL
|
يتم ترتيب القيم عموديًا (كصفوف). |