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)
    }
  ],
  "comments": [
    {
      object (CommentThread)
    }
  ],
  "commentsViewMode": enum (CommentsViewMode)
}
الحقول
spreadsheetId

string

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

object (SpreadsheetProperties)

الخصائص العامة لجدول بيانات
sheets[]

object (Sheet)

الأوراق التي تشكّل جزءًا من جدول بيانات
namedRanges[]

object (NamedRange)

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

string

تمثّل هذه السمة عنوان URL لجدول البيانات. هذا الحقل مخصّص للقراءة فقط.
developerMetadata[]

object (DeveloperMetadata)

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

object (DataSource)

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

object (DataSourceRefreshSchedule)

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

object (CommentThread)

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

commentsViewMode

enum (CommentsViewMode)

النتائج فقط. تمثّل هذه السمة وضع عرض التعليقات المطبَّق على جدول البيانات.

SpreadsheetProperties

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

تمثيل JSON 
{
  "title": string,
  "locale": string,
  "autoRecalc": enum (RecalculationInterval),
  "timeZone": string,
  "defaultFormat": {
    object (CellFormat)
  },
  "iterativeCalculationSettings": {
    object (IterativeCalculationSettings)
  },
  "spreadsheetTheme": {
    object (SpreadsheetTheme)
  },
  "importFunctionsExternalUrlAccessAllowed": boolean
}
الحقول
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)

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

boolean

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

RecalculationInterval

تعداد لخيارات إعادة الحساب المحتملة.

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

IterativeCalculationSettings

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

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

integer

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

number

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

SpreadsheetTheme

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

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

string

اسم مجموعة الخطوط الأساسية
themeColors[]

object (ThemeColorPair)

أزواج ألوان تصميم جدول البيانات يجب تقديم كل أزواج ألوان التصميم لإجراء التعديل.

ThemeColorPair

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

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

enum (ThemeColorType)

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

object (ColorStyle)

اللون المحدّد الذي يتوافق مع نوع لون المظهر.

NamedRange

نطاق مُعنوَن

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

string

تمثّل هذه السمة معرّف النطاق المُعنوَن.
name

string

تمثّل هذه السمة اسم النطاق المُعنوَن.
range

object (GridRange)

النطاق الذي يمثّله هذا العنصر.

DataSource

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

تمثيل 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 مرتبطة به. وإذا لم يتم تحديد الحقل، سيتم إنشاء رقم تعريف الورقة التي تم إنشاؤها بشكل عشوائي.

DataSourceSpec

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

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

  "bigQuery": {
    object (BigQueryDataSourceSpec)
  },
  "looker": {
    object (LookerDataSourceSpec)
  }
}
الحقول
parameters[]

object (DataSourceParameter)

معلَمات مصدر البيانات، التي يتم استخدامها عند طلب البيانات من مصدر البيانات
حقل الربط spec المواصفات الفعلية لكل نوع من أنواع مصادر البيانات يمكن أن يكون التعليق spec إحدى القيم التالية فقط:
bigQuery

object (BigQueryDataSourceSpec)

BigQueryDataSourceSpec
looker

object (LookerDataSourceSpec)

مصفوفة [LookerDatasourceSpec][].

BigQueryDataSourceSpec

تحديد مصدر بيانات BigQuery المرتبط بجدول بيانات

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

  "querySpec": {
    object (BigQueryQuerySpec)
  },
  "tableSpec": {
    object (BigQueryTableSpec)
  }
}
الحقول
projectId

string

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

object (BigQueryQuerySpec)

BigQueryQuerySpec
tableSpec

object (BigQueryTableSpec)

BigQueryTableSpec

BigQueryQuerySpec

تحدّد هذه السمة طلب بحث مخصّصًا في BigQuery.

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

string

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

BigQueryTableSpec

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

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

string

معرّف مشروع BigQuery الذي ينتمي إليه الجدول إذا لم يتم تحديدها، يتم استخدام projectId.
tableId

string

معرّف جدول BigQuery
datasetId

string

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

LookerDataSourceSpec

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

تمثيل JSON 
{
  "instanceUri": string,
  "model": string,
  "explore": string
}
الحقول
instanceUri

string

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

string

اسم نموذج Looker
explore

string

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

DataSourceParameter

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

تمثيل JSON 
{

  "name": string

  "namedRangeId": string,
  "range": {
    object (GridRange)
  }
}
الحقول
حقل الربط identifier معرّف المَعلمة يمكن أن يكون التعليق identifier إحدى القيم التالية فقط:
name

string

المَعلمة المُسمّاة يجب أن يكون معرّفًا صالحًا للسمة DataSource التي تتيح استخدامه. على سبيل المثال، معرّف BigQuery.
حقل الربط value قيمة المَعلمة يمكن أن يكون التعليق value إحدى القيم التالية فقط:
namedRangeId

string

معرّف NamedRange. يجب أن يكون حجمها 1x1.
range

object (GridRange)

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

DataSourceRefreshSchedule

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

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

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

  "dailySchedule": {
    object (DataSourceRefreshDailySchedule)
  },
  "weeklySchedule": {
    object (DataSourceRefreshWeeklySchedule)
  },
  "monthlySchedule": {
    object (DataSourceRefreshMonthlySchedule)
  }
}
الحقول
enabled

boolean

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

enum (DataSourceRefreshScope)

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

object (Interval)

النتائج فقط. الفاصل الزمني لعملية التشغيل التالية
حقل الربط schedule_config يمكن أن تكون إعدادات الجدول schedule_config إحدى القيم التالية فقط:
dailySchedule

object (DataSourceRefreshDailySchedule)

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

object (DataSourceRefreshWeeklySchedule)

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

object (DataSourceRefreshMonthlySchedule)

جدول إعادة الضبط الشهري

DataSourceRefreshScope

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

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

DataSourceRefreshDailySchedule

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

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

object (TimeOfDay)

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

TimeOfDay

تمثّل هذه السمة وقتًا من اليوم. لا يكون التاريخ والمنطقة الزمنية مهمّين أو يتم تحديدهما في مكان آخر. يمكن لواجهة برمجة التطبيقات اختيار السماح بالثواني الكبيسة. الأنواع ذات الصلة هي 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.

DataSourceRefreshWeeklySchedule

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

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

object (TimeOfDay)

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

enum (DayOfWeek)

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

DayOfWeek

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

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

DataSourceRefreshMonthlySchedule

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

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

object (TimeOfDay)

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

integer

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

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

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

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

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

string (Timestamp format)

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

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

string (Timestamp format)

اختياريّ. يمثّل نهاية الفاصل الزمني (غير مشمولة).

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

CommentThread

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

تمثيل JSON 
{
  "commentId": string,
  "anchorId": string,
  "headPost": {
    object (Post)
  },
  "replies": [
    {
      object (Post)
    }
  ],
  "status": enum (Status),

  "plainTextQuote": string
}
الحقول
commentId

string

المعرّف الفريد لسلسلة التعليقات.
anchorId

string

تمثّل هذه السمة معرّف CommentAnchor في ورقة البيانات المرتبطة بسلسلة المحادثات هذه.
headPost

object (Post)

المشاركة الأولى في سلسلة المحادثات
replies[]

object (Post)

الردود على المشاركة الرئيسية
status

enum (Status)

تُستخدَم لتحديد ما إذا كانت سلسلة المحادثات مفتوحة أو تم حلّها.
حقل الربط quote تمثّل هذه السمة النص المقتبس من المستند عند إنشاء التعليق. يمكن أن يكون التعليق quote إحدى القيم التالية فقط:
plainTextQuote

string

تمثّل هذه السمة النص المقتبس من جدول البيانات عند إنشاء التعليق، ويكون منسّقًا كنص عادي.

نشر

تمثّل هذه السمة منشورًا واحدًا في سلسلة تعليقات.

تمثيل JSON 
{
  "postId": string,
  "content": string,
  "contentHtml": string,
  "author": {
    object (PostAuthor)
  },
  "createTime": string,
  "updateTime": string,
  "deleted": boolean,
  "fromImportedSpreadsheet": boolean,
  "fromCopiedSpreadsheet": boolean,
  "assigneeEmail": string,
  "commentAction": enum (CommentActionType)
}
الحقول
postId

string

النتائج فقط. المعرّف الفريد للمشاركة.
content

string

تمثّل هذه السمة محتوى المشاركة.

يجب أن تكون هذه السمة غير فارغة إذا لم تكن قيمة commentAction هي RESOLVE أو REOPEN.

سيتم التعامل مع هذا المحتوى النصي بشكل مشابه للتعليقات التي تم إنشاؤها في محرّر "جداول بيانات Google". وسيكون لها سلوكيات مشابهة للتنسيق والإشعارات وما إلى ذلك.

يجب ألا يتجاوز 2048 وحدة رمز UTF-8.
contentHtml

string

النتائج فقط. محتوى المشاركة بتنسيق HTML
author

object (PostAuthor)

النتائج فقط. المستخدم الذي أنشأ المشاركة
createTime

string (Timestamp format)

النتائج فقط. الوقت الذي تم فيه إنشاء المشاركة
updateTime

string (Timestamp format)

النتائج فقط. يشير هذا العنصر إلى وقت آخر تعديل للمنشور.
deleted

boolean

النتائج فقط. تُستخدَم لتحديد ما إذا كانت المشاركة محذوفة أم لا. إذا كان true، سيكون الحقلان content وauthor فارغَين.
fromImportedSpreadsheet

boolean

النتائج فقط. تُستخدَم لتحديد ما إذا كانت المشاركة من جدول بيانات مستورد. لا يمكن للمتصلين ضبط هذا الحقل مباشرةً.
fromCopiedSpreadsheet

boolean

النتائج فقط. تُستخدَم لتحديد ما إذا كانت المشاركة من جدول بيانات منسوخ. لا يمكن للمتصلين ضبط هذا الحقل مباشرةً.
assigneeEmail

string

اختياريّ. عنوان البريد الإلكتروني للمستخدم الذي يتم تعيينه حديثًا في سلسلة المحادثات كجزء من هذا المنشور

يتم عرض رسالة الخطأ "400: طلب غير صالح" في الحالات التالية:

  • سلسلة الرسائل الرئيسية هي CommentThread التي لا تحتوي headPost على مستخدم معيّن.

  • يتم تحديد commentAction على أنّه RESOLVE أو REOPEN.

  • يتجاوز assigneeEmail وحدات ترميز UTF-8 البالغ عددها 2048.
commentAction

enum (CommentActionType)

الإجراء الذي تم اتخاذه كجزء من إنشاء المشاركة

PostAuthor

يمثّل هذا النوع مستخدمًا كتب مشاركة تتضمّن تعليقًا.

تمثيل JSON 
{
  "displayName": string,
  "me": boolean,
  "anonymous": boolean,
  "user": string
}
الحقول
displayName

string

الاسم المعروض للمستخدم قد لا تكون متوفّرة إذا كان المؤلف مجهول الهوية.
me

boolean

تُستخدَم لتحديد ما إذا كان المستخدم هو المستخدم الذي تمّت مصادقته والذي يرسل الطلب.
anonymous

boolean

توضّح ما إذا كان المستخدم مجهول الهوية.
user

string

اسم المورد الخاص بمستخدم مؤلف المشاركة، ويمكن استخدامه أيضًا لتحديد المستخدم في Google People API. التنسيق: users/{user} لن تتم تعبئته إذا كان الحقل المجهول true أو إذا كانت المشاركة من جدول بيانات مستورد.

CommentActionType

تمثّل هذه السمة الإجراء الذي تم اتخاذه بشأن هذا الردّ على سلسلة محادثات.

عمليات التعداد
COMMENT_ACTION_TYPE_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
NO_COMMENT_ACTION_CHANGE لم يتم إجراء أي تغيير على الإجراء في هذه المشاركة.
RESOLVE تحلّ هذه المشاركة سلسلة المحادثات.
REOPEN تعيد هذه المشاركة فتح سلسلة المحادثات.

الحالة

خيارات حالة سلسلة المحادثات

عمليات التعداد
STATUS_UNSPECIFIED القيمة التلقائية هذه القيمة غير مستخدَمة.
OPEN سلسلة التعليقات مفتوحة.
RESOLVED تمت الاستجابة إلى سلسلة التعليقات.

CommentsViewMode

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

عمليات التعداد
COMMENTS_VIEW_MODE_UNSPECIFIED لم يتم تحديد قيمة CommentsViewMode، وتم تطبيق COMMENTS_VIEW_MODE_OMITTED.
COMMENTS_VIEW_MODE_DEFAULT_FOR_CURRENT_ACCESS يعتمد CommentsViewMode المُطبَّق على جدول البيانات الذي تم عرضه على مستوى وصول المستخدم الحالي. إذا كان لدى المستخدم إذن بالاطّلاع فقط، يتم تطبيق COMMENTS_VIEW_MODE_OMITTED. بخلاف ذلك، يتم تطبيق التصنيف COMMENTS_VIEW_MODE_INCLUDED.
COMMENTS_VIEW_MODE_OMITTED يتم حذف التعليقات من جدول البيانات الذي تم إرجاعه.
COMMENTS_VIEW_MODE_INCLUDED

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

ستؤدي الطلبات التي يتم إرسالها لاسترداد جدول بيانات باستخدام هذا الوضع إلى عرض الخطأ 403 إذا لم يكن لدى المستخدم إذن بعرض التعليقات.

الطُرق

batchUpdate

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

create

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

get

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

getByDataFilter

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