REST Resource: spreadsheets

{
  "spreadsheetId": string,
  "properties": {
    object (SpreadsheetProperties)
  },
  "sheets": [
    {
      object (Sheet)
    }
  ],
  "namedRanges": [
    {
      object (NamedRange)
    }
  ],
  "spreadsheetUrl": string,
  "developerMetadata": [
    {
      object (DeveloperMetadata)
    }
  ],
  "dataSources": [
    {
      object (DataSource)
    }
  ],
  "dataSourceSchedules": [
    {
      object (DataSourceRefreshSchedule)
    }
  ]
}

string

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

object (SpreadsheetProperties)

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

object (Sheet)

الأوراق التي تشكل جزءًا من جدول بيانات.

object (NamedRange)

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

string

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

object (DeveloperMetadata)

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

object (DataSource)

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

object (DataSourceRefreshSchedule)

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

{
  "title": string,
  "locale": string,
  "autoRecalc": enum (RecalculationInterval),
  "timeZone": string,
  "defaultFormat": {
    object (CellFormat)
  },
  "iterativeCalculationSettings": {
    object (IterativeCalculationSettings)
  },
  "spreadsheetTheme": {
    object (SpreadsheetTheme)
  },
  "importFunctionsExternalUrlAccessAllowed": boolean
}

string

عنوان جدول البيانات.

string

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

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

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

• مزيج من رمز اللغة ISO ورمز البلد، مثل en_US

ملاحظة: عند تعديل هذا الحقل، لن تكون بعض اللغات/اللغات متاحة.

enum (RecalculationInterval)

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

string

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

object (CellFormat)

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

object (IterativeCalculationSettings)

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

object (SpreadsheetTheme)

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

boolean

تحديد ما إذا كان سيتم السماح بالوصول إلى عنوان URL الخارجي لوظائف الاستيراد والصور القراءة فقط عندما تكون true. عندما تكون false، يمكنك الضبط على true.

{
  "maxIterations": integer,
  "convergenceThreshold": number
}

integer

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

number

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

{
  "primaryFontFamily": string,
  "themeColors": [
    {
      object (ThemeColorPair)
    }
  ]
}

string

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

object (ThemeColorPair)

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

{
  "colorType": enum (ThemeColorType),
  "color": {
    object (ColorStyle)
  }
}

enum (ThemeColorType)

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

object (ColorStyle)

اللون الخرساني المتوافق مع نوع لون التصميم.

{
  "namedRangeId": string,
  "name": string,
  "range": {
    object (GridRange)
  }
}

string

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

string

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

object (GridRange)

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

{
  "dataSourceId": string,
  "spec": {
    object (DataSourceSpec)
  },
  "calculatedColumns": [
    {
      object (DataSourceColumn)
    }
  ],
  "sheetId": integer
}

string

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

object (DataSourceSpec)

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

object (DataSourceColumn)

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

integer

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

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

{
  "parameters": [
    {
      object (DataSourceParameter)
    }
  ],

  // Union field spec can be only one of the following:
  "bigQuery": {
    object (BigQueryDataSourceSpec)
  },
  "looker": {
    object (LookerDataSourceSpec)
  }
  // End of list of possible types for union field spec.
}

object (DataSourceParameter)

معلمات مصدر البيانات التي يتم استخدامها عند إجراء طلب بحث عن مصدر البيانات.

object (BigQueryDataSourceSpec)

BigQueryDataSourceSpec

object (LookerDataSourceSpec)

LookerDataSourceSpec

{
  "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.
}

string

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

object (BigQueryQuerySpec)

BigQueryQuerySpec

object (BigQueryTableSpec)

BigQueryTableSpec

{
  "rawQuery": string
}

string

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

{
  "tableProjectId": string,
  "tableId": string,
  "datasetId": string
}

string

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

string

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

string

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

{
  "instanceUri": string,
  "model": string,
  "explore": string
}

string

عنوان URL لنسخة Looker

string

اسم نموذج Looker

string

اسم استكشاف نموذج Looker

{

  // 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.
}

string

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

string

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

object (GridRange)

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

{
  "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.
}

boolean

صحيح إذا كان الجدول الزمني لإعادة التحميل مفعَّلاً، أو "خطأ" في الحالات الأخرى.

enum (DataSourceRefreshScope)

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

object (Interval)

النتائج فقط. الفاصل الزمني لعملية التشغيل التالية.

object (DataSourceRefreshDailySchedule)

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

object (DataSourceRefreshWeeklySchedule)

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

object (DataSourceRefreshMonthlySchedule)

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

{
  "startTime": {
    object (TimeOfDay)
  }
}

object (TimeOfDay)

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

{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}

integer

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

integer

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

integer

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

integer

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

{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfWeek": [
    enum (DayOfWeek)
  ]
}

object (TimeOfDay)

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

enum (DayOfWeek)

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

{
  "startTime": {
    object (TimeOfDay)
  },
  "daysOfMonth": [
    integer
  ]
}

object (TimeOfDay)

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

integer

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

{
  "startTime": string,
  "endTime": string
}

string (Timestamp format)

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

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

string (Timestamp format)

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

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