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)

مَعلمات مصدر البيانات، والتي تُستخدَم عند الاستعلام عن مصدر البيانات
المواصفات الفعلية لكل نوع من أنواع مصادر البيانات في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
bigQuery

object (BigQueryDataSourceSpec)

BigQueryDataSourceSpec
looker

object (LookerDataSourceSpec)

مصفوفة [LookerDatasourceSpec][].
نهاية الحقول التي يستبعد كلّ منها الآخر

BigQueryDataSourceSpec

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

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

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

string

معرّف مشروع Google Cloud مفعّل فيه BigQuery ومرفق به حساب فوترة يتم تحصيل رسوم من المشروع مقابل أي طلبات بحث يتم تنفيذها على مصدر البيانات.
المواصفات الفعلية في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
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)
  }
}
الحقول
معرّف المَعلمة في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
name

string

مَعلمة مسماة يجب أن يكون معرّفًا صالحًا DataSource يتيح استخدامه. على سبيل المثال، معرّف BigQuery.
نهاية الحقول التي يستبعد كلّ منها الآخر
قيمة المَعلمة في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
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)

النتائج فقط. الفاصل الزمني لعملية التشغيل التالية
إعدادات الجدول الزمني في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
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، ما يشير إلى اليوم الأول إلى اليوم الثامن والعشرين. يجب تحديد يوم واحد على الأقل.

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

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

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

تمثيل 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)

تُستخدَم لتحديد ما إذا كانت سلسلة المحادثات مفتوحة أو تم حلّها.
تمثّل هذه السمة النص المقتبس من المستند عند إنشاء التعليق. في ما يلي قائمة بالحقول التي يستبعد كلّ منها الآخر. سيتم ضبط حقل واحد على الأكثر في الرد:
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". وسيكون لها سلوكيات مشابهة في ما يتعلّق بالتنسيق والإشعارات وما إلى ذلك.

يجب ألا يتجاوز 2,048 وحدة رمز 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 2048 وحدة رمز UTF-8.
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

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