REST Resource: spreadsheets

المورد: جدول بيانات

مورد يمثّل جدول بيانات

تمثيل JSON
{
  "spreadsheetId": string,
  "properties": {
    object (SpreadsheetProperties)
  },
  "sheets": [
    {
      object (Sheet)
    }
  ],
  "namedRanges": [
    {
      object (NamedRange)
    }
  ],
  "spreadsheetUrl": string,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSources": [
    {
      object (DataSource)
    }
  ],
  "dataSourceSchedules": [
    {
      object (DataSourceRefreshSchedule)
    }
  ]
}
الحقول
spreadsheetId

string

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

properties

object (SpreadsheetProperties)

السمات العامة لجدول البيانات

sheets[]

object (Sheet)

جداول البيانات التي تشكّل جزءًا من جدول بيانات

namedRanges[]

object (NamedRange)

النطاقات المُعنوَنة التي تم تحديدها في جدول بيانات

spreadsheetUrl

string

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

developerMetadata[]

object (DeveloperMetadata)

البيانات الوصفية لمطوّر البرامج المرتبطة بجدول بيانات

dataSources[]

object (DataSource)

قائمة بمصادر البيانات الخارجية المرتبطة بجدول البيانات

dataSourceSchedules[]

object (DataSourceRefreshSchedule)

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

خصائص جدول البيانات

خصائص جدول البيانات.

تمثيل JSON
{
  "title": string,
  "locale": string,
  "autoRecalc": enum (RecalculationInterval),
  "timeZone": string,
  "defaultFormat": {
    object (CellFormat)
  },
  "iterativeCalculationSettings": {
    object (IterativeCalculationSettings)
  },
  "spreadsheetTheme": {
    object (SpreadsheetTheme)
  }
}
الحقول
title

string

تمثّل هذه السمة عنوان جدول البيانات.

locale

string

لغة جدول البيانات بأحد التنسيقات التالية:

  • رمز لغة وفقًا لمعيار ISO 639-1، مثل en

  • رمز لغة وفقًا لمعيار ISO 639-2، مثل fil، في حال عدم توفّر رمز 639-1

  • تركيبة من رمز اللغة وفقًا لمعيار ISO ورمز البلد، مثل en_US

ملاحظة: عند تحديث هذا الحقل، لا تتوفر جميع اللغات/اللغات.

autoRecalc

enum (RecalculationInterval)

إعادة حساب مدة الانتظار قبل إعادة احتساب الدوال المتغيّرة

timeZone

string

المنطقة الزمنية لجدول البيانات، بتنسيق CLDR، مثل America/New_York وفي حال عدم التعرّف على المنطقة الزمنية، قد تكون هذه منطقة زمنية مخصّصة مثل GMT-07:00.

defaultFormat

object (CellFormat)

التنسيق التلقائي لجميع الخلايا في جدول البيانات. لن يتم ضبط CellData.effectiveFormat إذا كان تنسيق الخلية يساوي هذا التنسيق التلقائي. هذا الحقل للقراءة فقط.

iterativeCalculationSettings

object (IterativeCalculationSettings)

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

spreadsheetTheme

object (SpreadsheetTheme)

تم تطبيق المظهر على جدول البيانات.

الفاصل الزمني لإعادة الاحتساب

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

عمليات التعداد
RECALCULATION_INTERVAL_UNSPECIFIED القيمة التلقائية يجب عدم استخدام هذه القيمة.
ON_CHANGE يتم تعديل الدوال المتغيّرة عند كل تغيير.
MINUTE يتم تعديل الدوال المتغيّرة عند كل تغيير وكل دقيقة.
HOUR يتم تعديل الدوال المتغيّرة في كل تغيير وكل ساعة.

إعدادات الاحتساب المكرر

إعدادات للتحكّم في كيفية حلّ مشاكل التبعية الدائرية باستخدام الحساب المكرّر

تمثيل JSON
{
  "maxIterations": integer,
  "convergenceThreshold": number
}
الحقول
maxIterations

integer

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

convergenceThreshold

number

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

مظهر جدول البيانات

يمثّل مظهر جدول البيانات

تمثيل JSON
{
  "primaryFontFamily": string,
  "themeColors": [
    {
      object (ThemeColorPair)
    }
  ]
}
الحقول
primaryFontFamily

string

اسم مجموعة الخطوط الأساسية.

themeColors[]

object (ThemeColorPair)

يتم إقران ألوان مظهر جدول البيانات. يجب تحديث جميع أزواج ألوان المظاهر للتعديل.

زوج مظاهر المظهر

يربط زوج من نوع لون مظهر جدول البيانات بلون الخرسانة الذي يمثله.

تمثيل JSON
{
  "colorType": enum (ThemeColorType),
  "color": {
    object (ColorStyle)
  }
}
الحقول
colorType

enum (ThemeColorType)

نوع لون مظهر جدول البيانات.

color

object (ColorStyle)

لون الخرسانة المقابل لنوع لون المظهر

الاسم المُعنون

نطاق مُعنوَن.

تمثيل JSON
{
  "namedRangeId": string,
  "name": string,
  "range": {
    object (GridRange)
  }
}
الحقول
namedRangeId

string

رقم تعريف النطاق المُعنوَن.

name

string

اسم النطاق المُعنوَن.

range

object (GridRange)

النطاق الذي يمثله.

مصدر البيانات

معلومات عن مصدر بيانات خارجي في جدول البيانات

تمثيل JSON
{
  "dataSourceId": string,
  "spec": {
    object (DataSourceSpec)
  },
  "calculatedColumns": [
    {
      object (DataSourceColumn)
    }
  ],
  "sheetId": integer
}
الحقول
dataSourceId

string

المعرّف الفريد على نطاق جدول البيانات الذي يحدّد مصدر البيانات. مثال: 1080547365.

spec

object (DataSourceSpec)

DataSourceSpec لمصدر البيانات المرتبط بجدول البيانات هذا.

calculatedColumns[]

object (DataSourceColumn)

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

sheetId

integer

رقم تعريف Sheet المرتبط بمصدر البيانات. لا يمكن تغيير الحقل بعد ضبطه.

عند إنشاء مصدر بيانات، يتم أيضًا إنشاء ورقة بيانات DATA_SOURCE مرتبطة، إذا لم يتم تحديد الحقل، سيتم إنشاء رقم تعريف ورقة البيانات التي يتم إنشاؤها بشكلٍ عشوائي.

مواصفات مصادر البيانات

يحدّد هذا الإجراء تفاصيل مصدر البيانات. على سبيل المثال، بالنسبة إلى BigQuery، يحدِّد هذا الإجراء معلومات عن مصدر BigQuery.

تمثيل JSON
{
  "parameters": [
    {
      object (DataSourceParameter)
    }
  ],

  // Union field spec can be only one of the following:
  "bigQuery": {
    object (BigQueryDataSourceSpec)
  }
  // End of list of possible types for union field spec.
}
الحقول
parameters[]

object (DataSourceParameter)

معلَمات مصدر البيانات، وتُستخدَم عند إجراء طلبات بحث عن مصدر البيانات

حقل الاتحاد spec. المواصفات الفعلية لكل نوع مصدر بيانات. لا يمكن أن يكون spec سوى واحد مما يلي:
bigQuery

object (BigQueryDataSourceSpec)

BigQueryDataSourceSpec.

مواصفات مصادر البيانات في BigQuery

مواصفات مصدر بيانات BigQuery المرتبط بورقة بيانات.

تمثيل JSON
{
  "projectId": string,

  // Union field spec can be only one of the following:
  "querySpec": {
    object (BigQueryQuerySpec)
  },
  "tableSpec": {
    object (BigQueryTableSpec)
  }
  // End of list of possible types for union field spec.
}
الحقول
projectId

string

رقم تعريف مشروع Google Cloud مفعَّل في BigQuery مع إرفاق حساب فوترة بالنسبة إلى أي طلبات بحث يتم تنفيذها على مصدر البيانات، يتم تحصيل رسوم المشروع.

حقل الاتحاد spec. المواصفات الفعلية لا يمكن أن يكون spec سوى واحد مما يلي:
querySpec

object (BigQueryQuerySpec)

BigQueryQuerySpec.

tableSpec

object (BigQueryTableSpec)

BigQueryTableSpec.

مواصفات BigQuerySearch

يتم تحديد طلب بحث مخصّص في BigQuery.

تمثيل JSON
{
  "rawQuery": string
}
الحقول
rawQuery

string

سلسلة طلب البحث الأولية.

مواصفات BigQueryTable

يحدّد تعريف جدول BigQuery. يُسمح فقط باستخدام الجداول المدمجة مع المحتوى.

تمثيل JSON
{
  "tableProjectId": string,
  "tableId": string,
  "datasetId": string
}
الحقول
tableProjectId

string

رقم تعريف مشروع BigQuery ينتمي إليه الجدول. ويتم استخدام السمة projectId في حال عدم تحديدها.

tableId

string

رقم تعريف جدول BigQuery

datasetId

string

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

معلّمة DataSource

معلَمة في طلب مصدر بيانات تسمح المَعلمة للمستخدم بتمرير القيم من جدول البيانات إلى طلب بحث.

تمثيل JSON
{

  // Union field identifier can be only one of the following:
  "name": string
  // End of list of possible types for union field identifier.

  // Union field value can be only one of the following:
  "namedRangeId": string,
  "range": {
    object (GridRange)
  }
  // End of list of possible types for union field value.
}
الحقول
حقل الاتحاد identifier. معرّف المعلّمة. لا يمكن أن يكون identifier سوى واحد مما يلي:
name

string

المعلمة المُسمّاة. يجب أن تكون معرِّفًا مشروعًا لـ DataSource الذي يدعمها. على سبيل المثال، معرِّف BigQuery.

حقل الاتحاد value. تمثّل هذه السمة قيمة المعلّمة. لا يمكن أن يكون value سوى واحد مما يلي:
namedRangeId

string

رقم تعريف NamedRange ويجب أن يكون حجمه 1×1.

range

object (GridRange)

نطاق يحتوي على قيمة المعلمة. ويجب أن يكون حجمه 1×1.

إعادة تحميل جدول البيانات المصدر

حدِّد موعد إعادة تحميل مصدر البيانات.

وتتم إعادة تحميل مصادر البيانات في جدول البيانات خلال فترة زمنية. يمكنك تحديد وقت البدء بالنقر على الزر "إعادة تحميل مُجدوَل" في أداة تحرير "جداول بيانات Google"، ولكن سيتم إصلاح الفاصل الزمني في 4 ساعات. على سبيل المثال، إذا حدّدت وقت البدء في الساعة 8 صباحًا، ستتم عملية التحديث بين الساعة 8 صباحًا و12 مساءً كل يوم.

تمثيل JSON
{
  "enabled": boolean,
  "refreshScope": enum (DataSourceRefreshScope),
  "nextRun": {
    object (Interval)
  },

  // Union field schedule_config can be only one of the following:
  "dailySchedule": {
    object (DataSourceRefreshDailySchedule)
  },
  "weeklySchedule": {
    object (DataSourceRefreshWeeklySchedule)
  },
  "monthlySchedule": {
    object (DataSourceRefreshMonthlySchedule)
  }
  // End of list of possible types for union field schedule_config.
}
الحقول
enabled

boolean

صحيح إذا كان جدول إعادة التحميل مفعّلاً أو غير صحيح.

refreshScope

enum (DataSourceRefreshScope)

نطاق إعادة التحميل يجب أن يكون ALL_DATA_SOURCES.

nextRun

object (Interval)

الإخراج فقط. الفاصل الزمني للتشغيل التالي

حقل الاتحاد schedule_config. يمكن أن تكون عمليات ضبط الجدول الزمني schedule_config واحدًا فقط من الخيارات التالية:
dailySchedule

object (DataSourceRefreshDailySchedule)

الجدول الزمني لإعادة التحميل اليومية

weeklySchedule

object (DataSourceRefreshWeeklySchedule)

جدول إعادة التحميل الأسبوعي

monthlySchedule

object (DataSourceRefreshMonthlySchedule)

جدول التحديث الشهري

إعادة تحميل بيانات المصدر

نطاقات إعادة تحميل مصدر البيانات

عمليات التعداد
DATA_SOURCE_REFRESH_SCOPE_UNSPECIFIED القيمة التلقائية هي "عدم الاستخدام".
ALL_DATA_SOURCES إعادة تحميل كل مصادر البيانات وعناصر مصدر البيانات المرتبطة بها في جدول البيانات

إعادة تحميل البيانات اليومية

جدول زمني لإعادة تحميل البيانات كل يوم في فترة زمنية معيّنة

تمثيل JSON
{
  "startTime": {
    object (TimeOfDay)
  }
}
الحقول
startTime

object (TimeOfDay)

وقت بدء الفاصل الزمني الذي تمت فيه جدولة إعادة تحميل مصدر البيانات. يتم استخدام جزء واحد (hours) فقط. يتم ضبط حجم الفاصل الزمني بشكل تلقائي على هذا الحجم في "محرّر جداول البيانات".

الوقت من اليوم

تمثّل وقتًا من اليوم. التاريخ والمنطقة الزمنية ليسا مهمين أو يتم تحديدهما في مكان آخر. قد تختار واجهة برمجة التطبيقات السماح بالقفز الثواني. الأنواع ذات الصلة هي google.type.Date وgoogle.protobuf.Timestamp.

تمثيل JSON
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
الحقول
hours

integer

ساعات من اليوم بتنسيق 24 ساعة. يجب أن تتراوح القيمة بين 0 و23. قد تختار واجهة برمجة التطبيقات السماح بالقيمة "24:00:00" للسيناريوهات مثل وقت إغلاق النشاط التجاري.

minutes

integer

دقائق من اليوم يجب أن تتراوح القيمة بين 0 و59.

seconds

integer

الثواني من الوقت يجب أن تتراوح القيمة عادةً بين 0 و59. يمكن أن تسمح واجهة برمجة التطبيقات بالقيمة 60 إذا كانت تسمح بالكبيس لمدة ثانيتَين.

nanos

integer

كسور من الثواني بالنانو ثانية. يجب أن تتراوح القيمة بين 0 و999,999,999.

إعادة تحميل الجدول الزمني للبيانات

جدول زمني أسبوعي لإعادة تحميل البيانات في أيام محدّدة في فاصل زمني محدّد

تمثيل JSON
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}
الحقول
startTime

object (TimeOfDay)

وقت بدء الفاصل الزمني الذي تمت فيه جدولة إعادة تحميل مصدر البيانات. يتم استخدام جزء واحد (hours) فقط. يتم ضبط حجم الفاصل الزمني بشكل تلقائي على هذا الحجم في "محرّر جداول البيانات".

daysOfWeek[]

enum (DayOfWeek)

أيام الأسبوع التي يتم فيها إعادة تحميل الصفحة. يجب تحديد يوم واحد على الأقل.

يوم من الأسبوع

تمثّل يومًا من الأسبوع.

عمليات التعداد
DAY_OF_WEEK_UNSPECIFIED يُرجى العِلم أنّ اليوم من الأسبوع غير محدَّد.
MONDAY الاثنين
TUESDAY الثلاثاء
WEDNESDAY الأربعاء
THURSDAY الخميس
FRIDAY الجمعة
SATURDAY السبت
SUNDAY الأحد

إعادة تحميل جدول البيانات الشهري

جدول زمني شهري لإعادة تحميل البيانات في أيام محدّدة من الشهر خلال فترة زمنية معيّنة

تمثيل JSON
{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfMonth": [
    integer
  ]
}
الحقول
startTime

object (TimeOfDay)

وقت بدء الفاصل الزمني الذي تمت فيه جدولة إعادة تحميل مصدر البيانات. يتم استخدام جزء واحد (hours) فقط. يتم ضبط حجم الفاصل الزمني بشكل تلقائي على هذا الحجم في "محرّر جداول البيانات".

daysOfMonth[]

integer

أيام الشهر لإعادة التحميل يتم دعم 1-28 فقط، مع تعيين اليوم الأول إلى اليوم الثامن والعشرين. يجب تحديد يوم واحد على الأقل.

الفاصل الزمني

تمثل فاصلاً زمنيًا، تم ترميزه كبداية لطابع زمني (شاملة) ونهاية لطابع زمني (حصري).

يجب أن تكون البداية أقل من أو تساوي النهاية. عندما تكون قيمة البداية تساوي النهاية، يكون الفاصل فارغًا (لا يتطابق مع أي وقت). وعند عدم تحديد البداية والنهاية، يتطابق الفاصل الزمني في أي وقت.

تمثيل JSON
{
  "startTime": string,
  "endTime": string
}
الحقول
startTime

string (Timestamp format)

اختياريّ. بداية شاملة للفاصل الزمني

وفي حال تحديد طابع زمني، يجب أن يكون الطابع الزمني متطابقًا مع هذا الفاصل الزمني أو بعده.

endTime

string (Timestamp format)

اختياريّ. نهاية حصرية للفاصل الزمني

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

الطُرق

batchUpdate

يتم تطبيق تحديث واحد أو أكثر على جدول البيانات.

create

يُنشئ جدول بيانات ويعرض جدول البيانات الذي تم إنشاؤه حديثًا.

get

لعرض جدول البيانات برقم التعريف المعيّن.

getByDataFilter

لعرض جدول البيانات برقم التعريف المعيّن.