الطلب
نوع واحد من التعديل يمكن تطبيقه على جدول بيانات.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
kind . نوع التحديث. يجب ملء حقل واحد فقط.
يمكن أن تكون السمة kind واحدًا فقط مما يلي:
|
|
updateSpreadsheetProperties
|
لتعديل خصائص جدول البيانات. |
updateSheetProperties
|
لتعديل خصائص الورقة. |
updateDimensionProperties
|
يعدِّل سمات السمات. |
updateNamedRange
|
لتعديل نطاق مُعنوَن. |
repeatCell
|
لتكرار خلية واحدة في نطاق. |
addNamedRange
|
لإضافة نطاق مُعنوَن. |
deleteNamedRange
|
لحذف نطاق مُعنوَن. |
addSheet
|
لإضافة ورقة. |
deleteSheet
|
لحذف ورقة. |
autoFill
|
يتم ملء المزيد من البيانات تلقائيًا استنادًا إلى البيانات الحالية. |
cutPaste
|
يقص البيانات من منطقة ويلصقها إلى منطقة أخرى. |
copyPaste
|
نسخ البيانات من منطقة ولصقها في منطقة أخرى |
mergeCells
|
يدمج الخلايا معًا. |
unmergeCells
|
إلغاء دمج الخلايا المدمجة. |
updateBorders
|
لتعديل الحدود في نطاق من الخلايا |
updateCells
|
تحدّث العديد من الخلايا في آنٍ واحد. |
addFilterView
|
لإضافة عرض فلتر. |
appendCells
|
لإلحاق الخلايا بعد الصف الأخير بالبيانات في ورقة. |
clearBasicFilter
|
لمحو الفلتر الأساسي في ورقة ما. |
deleteDimension
|
لحذف الصفوف أو الأعمدة في ورقة. |
deleteEmbeddedObject
|
حذف عنصر مضمّن (على سبيل المثال، رسم بياني أو صورة) في ورقة بيانات |
deleteFilterView
|
لحذف عرض فلتر من ورقة. |
duplicateFilterView
|
تكرار عرض فلتر |
duplicateSheet
|
إنشاء نسخة طبق الأصل من ورقة بيانات |
findReplace
|
للبحث عن مواضع ورود بعض النص واستبدالها بنص آخر. |
insertDimension
|
لإدراج صفوف أو أعمدة جديدة في ورقة. |
insertRange
|
إدراج خلايا جديدة في ورقة، وتغيير الخلايا الحالية |
moveDimension
|
لنقل الصفوف أو الأعمدة إلى موقع آخر في ورقة بيانات. |
updateEmbeddedObjectPosition
|
تعديل موضع عنصر مضمّن (على سبيل المثال، رسم بياني أو صورة) |
pasteData
|
يلصق البيانات (بتنسيق HTML أو بتنسيق محدّد) في ورقة بيانات. |
textToColumns
|
لتحويل عمود من النص إلى عدة أعمدة نصية. |
updateFilterView
|
لتعديل خصائص عرض فلتر |
deleteRange
|
لحذف نطاق من الخلايا من ورقة، وتحويل الخلايا المتبقية |
appendDimension
|
لإلحاق الأبعاد بنهاية ورقة البيانات. |
addConditionalFormatRule
|
تضيف قاعدة تنسيق شرطي جديدة. |
updateConditionalFormatRule
|
لتعديل قاعدة تنسيق شرطي حالية |
deleteConditionalFormatRule
|
يؤدي هذا الإجراء إلى حذف قاعدة تنسيق شرطي حالية. |
sortRange
|
يفرز البيانات في نطاق. |
setDataValidation
|
لضبط التحقق من صحة البيانات لخلية واحدة أو أكثر. |
setBasicFilter
|
لضبط الفلتر الأساسي على ورقة. |
addProtectedRange
|
لإضافة نطاق محمي. |
updateProtectedRange
|
يحدّث نطاقًا محميًا. |
deleteProtectedRange
|
لحذف نطاق محمي. |
autoResizeDimensions
|
يتم تلقائيًا تغيير حجم بُعد واحد أو أكثر استنادًا إلى محتوى الخلايا في هذا البُعد. |
addChart
|
لإضافة رسم بياني |
updateChartSpec
|
لتعديل مواصفات الرسم البياني |
updateBanding
|
لتعديل نطاق بنطاق ترددي |
addBanding
|
إضافة نطاق بنطاق ترددي جديد |
deleteBanding
|
إزالة نطاق ذي نطاق ترددي |
createDeveloperMetadata
|
تنشئ بيانات وصفية جديدة للمطوّرين. |
updateDeveloperMetadata
|
لتعديل إدخال حالي للبيانات الوصفية للمطوِّر |
deleteDeveloperMetadata
|
يحذف البيانات الوصفية للمطوِّرين. |
randomizeRange
|
ترتيب الصفوف في نطاق عشوائيًا. |
addDimensionGroup
|
ينشئ مجموعة في النطاق المحدد. |
deleteDimensionGroup
|
حذف مجموعة خلال النطاق المحدد |
updateDimensionGroup
|
تعمل على تعديل حالة المجموعة المحدّدة. |
trimWhitespace
|
لاقتطاع خلايا المسافات البيضاء (مثل المسافات أو علامات التبويب أو الأسطر الجديدة). |
deleteDuplicates
|
لإزالة الصفوف التي تحتوي على قيم مكررة في أعمدة محددة من نطاق الخلايا. |
updateEmbeddedObjectBorder
|
لتحديث حد العنصر المضمّن. |
addSlicer
|
إضافة فلتر نطاق بيانات |
updateSlicerSpec
|
يعدِّل مواصفات فلتر نطاق بيانات. |
addDataSource
|
لإضافة مصدر بيانات. |
updateDataSource
|
لتعديل مصدر بيانات |
deleteDataSource
|
لحذف مصدر بيانات. |
refreshDataSource
|
لإعادة تحميل مصدر واحد أو أكثر من مصادر البيانات وكائنات dbObject المرتبطة بها. |
cancelDataSourceRefresh
|
لإلغاء عمليات إعادة تحميل مصدر واحد أو عدة بيانات وكائنات dbObject المرتبطة بها. |
UpdateSpreadsheetPropertiesRequest
لتعديل خصائص جدول البيانات.
تمثيل JSON |
---|
{
"properties": {
object (
|
الحقول | |
---|---|
properties
|
السمات المطلوب تعديلها |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. إنّ جذر "الخصائص" متضمّن ويجب عدم تحديده. يمكن استخدام
|
UpdateSheetPropertiesRequest
تُعدِّل خصائص ورقة البيانات باستخدام sheetId
المحدّد.
تمثيل JSON |
---|
{
"properties": {
object (
|
الحقول | |
---|---|
properties
|
السمات المطلوب تعديلها |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. الجذر |
UpdateDimensionPropertiesRequest
يحدّث خصائص الأبعاد ضمن النطاق المحدد.
تمثيل JSON |
---|
{ "properties": { object ( |
الحقول | |
---|---|
properties
|
المواقع المطلوب تعديلها |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. الجذر |
حقل الاتحاد
dimension_range . نطاق السمات.
يمكن أن تكون السمة dimension_range واحدًا فقط مما يلي:
|
|
range
|
الصفوف أو الأعمدة المطلوب تعديلها |
dataSourceSheetRange
|
الأعمدة في ورقة مصدر البيانات المطلوب تعديلها. |
DataSourceSheetDimensionRange
نطاق على بُعد واحد في ورقة بيانات DATA_SOURCE
تمثيل JSON |
---|
{
"sheetId": integer,
"columnReferences": [
{
object (
|
الحقول | |
---|---|
sheetId
|
رقم تعريف ورقة مصدر البيانات التي يتوفّر فيها النطاق. |
columnReferences[]
|
الأعمدة الموجودة في ورقة مصدر البيانات. |
UpdateNamedRangeRequest
تُعدِّل خصائص النطاق المُعنون باستخدام namedRangeId
المحدَّد.
تمثيل JSON |
---|
{
"namedRange": {
object (
|
الحقول | |
---|---|
namedRange
|
النطاق المُعنون الذي سيتم تعديله باستخدام المواقع الجديدة |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. الجذر |
RepeatCellRequest
لتعديل جميع الخلايا في النطاق إلى القيم في كائن الخلية المحدّد ويتم فقط تعديل الحقول المدرَجة في الحقل fields
، أما الحقول الأخرى، فلن يتم تعديلها.
في حال كتابة خلية باستخدام صيغة، ستزيد نطاقات الصيغة تلقائيًا لكل حقل في النطاق. على سبيل المثال، إذا كتابة خلية تحتوي على الصيغة =A1
في النطاق B2:C4 سيكون B2 هو =A1
وB3 سيكون =A2
وB4 سيكون =A3
وC2 سيكون =B1
وC3 إلى =B2
وC4 سيكون =B3
.
لإبقاء نطاقات الصيغة ثابتة، استخدِم مؤشر $
. على سبيل المثال، استخدِم الصيغة
=$A$1
لمنع تزايد كل من الصف والعمود.
تمثيل JSON |
---|
{ "range": { object ( |
الحقول | |
---|---|
range
|
النطاق المطلوب تكرار الخلية فيه. |
cell
|
البيانات المراد كتابتها. |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. الجذر |
AddNamedRangeRequest
لإضافة نطاق مُعنوَن إلى جدول البيانات
تمثيل JSON |
---|
{
"namedRange": {
object (
|
الحقول | |
---|---|
namedRange
|
النطاق المُعنون المطلوب إضافته يُرجى العلم أنّ الحقل |
DeleteNamedRangeRequest
يُزيل النطاق المُعنوَن برقم التعريف المحدَّد من جدول البيانات.
تمثيل JSON |
---|
{ "namedRangeId": string } |
الحقول | |
---|---|
namedRangeId
|
رقم تعريف النطاق المُعنون الذي تريد حذفه. |
AddSheetRequest
لإضافة ورقة جديدة. عند إضافة ورقة في فهرس معين، تتم زيادة فهارس الأوراق التالية. لإضافة ورقة عنصر، استخدِم AddChartRequest
بدلاً من ذلك، وحدِّد EmbeddedObjectPosition.sheetId
أو EmbeddedObjectPosition.newSheet
.
تمثيل JSON |
---|
{
"properties": {
object (
|
الحقول | |
---|---|
properties
|
الخصائص التي يجب أن تحتوي عليها ورقة البيانات الجديدة. وجميع السمات اختيارية. يُرجى العلم أنّ الحقل |
DeleteSheetRequest
يؤدي إلى حذف ورقة البيانات المطلوبة.
تمثيل JSON |
---|
{ "sheetId": integer } |
الحقول | |
---|---|
sheetId
|
رقم تعريف ورقة البيانات المطلوب حذفها.
إذا كان نوع جدول البيانات
|
AutoFillRequest
يملأ المزيد من البيانات بناءً على البيانات الموجودة.
تمثيل JSON |
---|
{ "useAlternateSeries": boolean, // Union field |
الحقول | |
---|---|
useAlternateSeries
|
صحيح إذا كان يجب إنشاء بيانات باستخدام السلسلة "البديلة". ويختلف هذا بناءً على نوع وكمية بيانات المصدر. |
حقل الاتحاد
area . المنطقة التي سيتم ملؤها تلقائيًا.
يمكن أن تكون السمة area واحدًا فقط مما يلي:
|
|
range
|
نطاق الملء التلقائي. سيؤدي هذا إلى فحص النطاق واكتشاف الموقع الذي يحتوي على بيانات وملء تلك البيانات تلقائيًا إلى بقية النطاق. |
sourceAndDestination
|
منطقتَا المصدر والوجهة التي سيتم ملؤها تلقائيًا. يسرد هذا بوضوح مصدر الملء التلقائي ومكان توسيع هذه البيانات. |
SourceAndDestination
مجموعة من نطاق المصدر وكيفية تمديده.
تمثيل JSON |
---|
{ "source": { object ( |
الحقول | |
---|---|
source
|
موقع البيانات المطلوب استخدامها كمصدر للملء التلقائي. |
dimension
|
السمة التي يجب ملء البيانات بها. |
fillLength
|
عدد الصفوف أو الأعمدة التي يجب ملء البيانات فيها. وتتوسّع الأرقام الموجبة إلى ما بعد الصف الأخير أو العمود الأخير من المصدر. يتم توسيع الأرقام السالبة قبل الصف الأول أو العمود الأول من المصدر. |
CutPasteRequest
تنقل البيانات من المصدر إلى الوجهة.
تمثيل JSON |
---|
{ "source": { object ( |
الحقول | |
---|---|
source
|
بيانات المصدر المطلوب قصها. |
destination
|
الإحداثيات العلوية اليسرى حيث يجب لصق البيانات. |
pasteType
|
نوع البيانات المطلوب لصقها سيتم قص جميع بيانات المصدر، بغض النظر عما يتم لصقه. |
PasteType
ما نوع البيانات التي يجب لصقها.
عمليات التعداد | |
---|---|
PASTE_NORMAL
|
لصق القيم والمعادلات والتنسيقات وعمليات الدمج |
PASTE_VALUES
|
لصق القيم فقط بدون تنسيقات أو صيغ أو عمليات دمج. |
PASTE_FORMAT
|
الصق التنسيق والتحقق من صحة البيانات فقط. |
PASTE_NO_BORDERS
|
مثل PASTE_NORMAL
ولكن بدون حدود.
|
PASTE_FORMULA
|
الصق الصيغ فقط. |
PASTE_DATA_VALIDATION
|
الصق التحقق من صحة البيانات فقط. |
PASTE_CONDITIONAL_FORMATTING
|
يُرجى لصق قواعد التنسيق الشرطي فقط. |
CopyPasteRequest
يتم نسخ البيانات من المصدر إلى الوجهة.
تمثيل JSON |
---|
{ "source": { object ( |
الحقول | |
---|---|
source
|
النطاق المصدر المطلوب نسخه |
destination
|
الموقع المطلوب اللصق إليه. إذا كان النطاق يغطي مدى مضاعفات ارتفاع المصدر أو عرضه، سيتم تكرار البيانات لملء نطاق الوجهة. إذا كان النطاق أصغر من نطاق المصدر، سيستمر نسخ بيانات المصدر بالكامل (بعد نهاية نطاق الوجهة). |
pasteType
|
نوع البيانات المطلوب لصقها |
pasteOrientation
|
كيف يجب توجيه هذه البيانات عند اللصق. |
PasteOrientation
طريقة تنفيذ عملية اللصق
عمليات التعداد | |
---|---|
NORMAL
|
اللصق كالمعتاد. |
TRANSPOSE
|
لصق مع التحويل، حيث تصبح جميع الصفوف أعمدة والعكس صحيح. |
MergeCellsRequest
يدمج كل الخلايا في النطاق.
تمثيل JSON |
---|
{ "range": { object ( |
الحقول | |
---|---|
range
|
نطاق الخلايا المراد دمجها. |
mergeType
|
كيف يجب دمج الخلايا. |
MergeType
نوع الدمج المراد إنشاؤه.
عمليات التعداد | |
---|---|
MERGE_ALL
|
إنشاء عملية دمج واحدة من النطاق |
MERGE_COLUMNS
|
إنشاء عملية دمج لكل عمود في النطاق |
MERGE_ROWS
|
إنشاء عملية دمج لكل صف في النطاق |
UnmergeCellsRequest
لإلغاء دمج الخلايا في النطاق المحدد.
تمثيل JSON |
---|
{
"range": {
object (
|
الحقول | |
---|---|
range
|
النطاق الذي يجب إلغاء دمج جميع الخلايا فيه. إذا امتد النطاق إلى عمليات دمج متعددة، سيتم إلغاء دمج الكل. يجب ألا يغطّي النطاق أي عملية دمج جزئيًا. |
UpdateBordersRequest
لتعديل حدود النطاق إذا لم يتم ضبط حقل في الطلب، يعني ذلك أنّ الحد يظل كما هو، على سبيل المثال، مع طلبَي UpdateBordersRequest لاحقَين:
-
النطاق: A1:A5
{ top: RED, bottom: WHITE }
-
النطاق: A1:A5
{ left: BLUE }
سينتج عن ذلك ضبط حدود A1:A5 على { top: RED, bottom: WHITE, left: BLUE }
. وإذا أردت محو أحد الحدود، اضبط النمط صراحةً على NONE
.
تمثيل JSON |
---|
{ "range": { object ( |
الحقول | |
---|---|
range
|
النطاق الذي يجب تعديل حدوده. |
top
|
الحد المطلوب وضعه في أعلى النطاق. |
bottom
|
الحد المطلوب وضعه أسفل النطاق. |
left
|
الحد المطلوب وضعه على يسار النطاق. |
right
|
الحد المطلوب وضعه على يمين النطاق. |
innerHorizontal
|
الحد الأفقي المطلوب وضعه ضمن النطاق. |
innerVertical
|
الحد العمودي المراد وضعه ضمن النطاق. |
UpdateCellsRequest
لتعديل جميع الخلايا في النطاق ببيانات جديدة.
تمثيل JSON |
---|
{ "rows": [ { object ( |
الحقول | |
---|---|
rows[]
|
البيانات المراد كتابتها. |
fields
|
حقول CellData التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. الجذر هو CellData؛ ويجب عدم تحديد "row.values.". يمكن استخدام
|
حقل الاتحاد
area . يجب كتابة بيانات الموقع. يجب ضبط قيمة واحدة بالضبط.
يمكن أن تكون السمة area واحدًا فقط مما يلي:
|
|
start
|
الإحداثي لبدء كتابة البيانات عليه. يمكن كتابة أي عدد من الصفوف والأعمدة (بما في ذلك عدد مختلف من الأعمدة لكل صف). |
range
|
النطاق المراد كتابة البيانات إليه.
إذا كانت البيانات في الصفوف لا تغطي النطاق المطلوب بالكامل، سيتم محو الحقول التي تتطابق مع تلك المجموعة في
|
AddFilterViewRequest
لإضافة عرض فلتر.
تمثيل JSON |
---|
{
"filter": {
object (
|
الحقول | |
---|---|
filter
|
الفلتر المطلوب إضافته. يُرجى العلم أنّ الحقل |
AppendCellsRequest
لإضافة خلايا جديدة بعد الصف الأخير مع بيانات في ورقة، مع إدراج صفوف جديدة في الورقة إذا لزم الأمر.
تمثيل JSON |
---|
{
"sheetId": integer,
"rows": [
{
object (
|
الحقول | |
---|---|
sheetId
|
رقم تعريف ورقة البيانات المطلوب إلحاق البيانات بها. |
rows[]
|
البيانات المطلوب إلحاقها. |
fields
|
حقول CellData التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. الجذر هو CellData؛ ويجب عدم تحديد "row.values.". يمكن استخدام
|
ClearBasicFilterRequest
محو الفلتر الأساسي، في حال توفّره في ورقة البيانات.
تمثيل JSON |
---|
{ "sheetId": integer } |
الحقول | |
---|---|
sheetId
|
معرِّف الورقة الذي يجب محو الفلتر الأساسي منه. |
DeleteDimensionRequest
لحذف السمات من ورقة البيانات.
تمثيل JSON |
---|
{
"range": {
object (
|
الحقول | |
---|---|
range
|
السمات المطلوب حذفها من ورقة البيانات. |
DeleteEmbeddedObjectRequest
يؤدي هذا الإجراء إلى حذف العنصر المضمَّن الذي يتضمّن المعرّف المحدَّد.
تمثيل JSON |
---|
{ "objectId": integer } |
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر المضمّن المطلوب حذفه. |
DeleteFilterViewRequest
حذف عرض فلتر معيّن.
تمثيل JSON |
---|
{ "filterId": integer } |
الحقول | |
---|---|
filterId
|
رقم تعريف الفلتر المطلوب حذفه. |
DuplicateFilterViewRequest
تكرار عرض فلتر معين.
تمثيل JSON |
---|
{ "filterId": integer } |
الحقول | |
---|---|
filterId
|
رقم تعريف الفلتر المكرر. |
DuplicateSheetRequest
لتكرار محتوى ورقة بيانات.
تمثيل JSON |
---|
{ "sourceSheetId": integer, "insertSheetIndex": integer, "newSheetId": integer, "newSheetName": string } |
الحقول | |
---|---|
sourceSheetId
|
الورقة المطلوب تكرارها.
إذا كان نوع ورقة البيانات المصدر من
النوع |
insertSheetIndex
|
الفهرس المستند إلى صفر والذي يجب إدراج الورقة الجديدة فيه. تتم زيادة فهرس كل الأوراق بعد ذلك. |
newSheetId
|
إذا تم تعيينه، معرِّف الورقة الجديدة. وفي حال تركها بدون ضبط، يتم اختيار رقم تعريفي. إذا تم ضبطها، يجب ألا يتعارض رقم التعريف مع أي رقم تعريف ورقة بيانات حالي. وإذا تم ضبطها، يجب أن تكون قيمة غير سالبة. |
newSheetName
|
اسم الورقة الجديدة. إذا كان الحقل فارغًا، يتم اختيار اسم جديد لك. |
FindReplaceRequest
للبحث عن البيانات واستبدالها في الخلايا ضمن نطاق أو ورقة بيانات أو جميع الأوراق
تمثيل JSON |
---|
{ "find": string, "replacement": string, "matchCase": boolean, "matchEntireCell": boolean, "searchByRegex": boolean, "includeFormulas": boolean, // Union field |
الحقول | |
---|---|
find
|
قيمة البحث. |
replacement
|
القيمة المطلوب استخدامها كبديل. |
matchCase
|
صحيح إذا كان البحث حساسًا لحالة الأحرف. |
matchEntireCell
|
True إذا كان يجب أن تتطابق قيمة البحث مع الخلية بأكملها. |
searchByRegex
|
صحيح إذا كانت قيمة البحث عبارة عن تعبير عادي. ويجب أن يتّبع التعبير العادي والاستبدال قواعد التعبير العادي في Java على
https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html. تُسمَح لسلسلة الاستبدال بالإشارة إلى مجموعات الالتقاط. على سبيل المثال، إذا كانت إحدى الخلايا تحتوي على المحتوى |
includeFormulas
|
True إذا كان البحث يجب أن يتضمن خلايا تحتوي على صيغ. خطأ لتخطي الخلايا التي تحتوي على صيغ. |
حقل الاتحاد
scope . النطاق الذي يتم البحث/استبداله - يجب تحديد نطاق واحد فقط.
يمكن أن تكون السمة scope واحدًا فقط مما يلي:
|
|
range
|
النطاق الذي تريد البحث عنه أو استبداله |
sheetId
|
ورقة البيانات المطلوب البحث عنها أو استبدالها. |
allSheets
|
صحيح للبحث/الاستبدال في كل الأوراق. |
InsertDimensionRequest
لإدراج صفوف أو أعمدة في ورقة عند فهرس معين.
تمثيل JSON |
---|
{
"range": {
object (
|
الحقول | |
---|---|
range
|
الأبعاد المطلوب إدراجها. يجب ربط كل من فهرس البداية والنهاية. |
inheritFromBefore
|
ما إذا كان يجب توسيع سمات السمات من السمات قبل السمات التي تم إدراجها حديثًا أو بعدها. صحيح ليتم اكتسابه من الأبعاد السابقة (في هذه الحالة يجب أن يكون فهرس البدء أكبر من 0)، وعلى false ليكتسب من الأبعاد السابقة.
على سبيل المثال، إذا كان فهرس الصف 0 له خلفية حمراء ويحتوي فهرس الصف 1 على خلفية خضراء، فإن إدراج صفين في الفهرس 1 يمكن أن يكتسب إما الخلفية الخضراء أو الخلفية الحمراء. إذا كانت قيمة |
InsertRangeRequest
لإدراج خلايا في نطاق، ونقل الخلايا الحالية للأعلى أو للأسفل.
تمثيل JSON |
---|
{ "range": { object ( |
الحقول | |
---|---|
range
|
النطاق المراد إدراج خلايا جديدة فيه. |
shiftDimension
|
السمة التي سيتم تغييرها عند إدراج الخلايا. إذا
|
MoveDimensionRequest
لنقل صف أو عمود واحد أو أكثر.
تمثيل JSON |
---|
{
"source": {
object (
|
الحقول | |
---|---|
source
|
سمات المصدر المطلوب نقلها. |
destinationIndex
|
يشير ذلك إلى مؤشر البدء المستند إلى الصفر للمكان الذي سيتم نقل بيانات المصدر إليه، وذلك استنادًا إلى الإحداثيات قبل إزالة بيانات المصدر من الشبكة. وسيتم نقل البيانات الحالية إلى الأسفل أو إلى اليمين (استنادًا إلى السمة) لتوفير مساحة للسمات التي تم نقلها. تتم إزالة أبعاد المصدر من الشبكة، لذلك قد ينتهي الأمر بالبيانات في فهرس مختلف عن المحدد.
على سبيل المثال، إذا كان |
UpdateEmbeddedObjectPositionRequest
تعديل موضع عنصر مضمّن (مثل تحريك أو تغيير حجم الرسم البياني أو الصورة)
تمثيل JSON |
---|
{
"objectId": integer,
"newPosition": {
object (
|
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر المطلوب نقله. |
newPosition
|
موضع صريح لنقل العنصر المضمَّن إليه. في حال ضبط |
fields
|
حقول |
PasteDataRequest
يدرج البيانات في جدول البيانات بدءًا من الإحداثي المحدد.
تمثيل JSON |
---|
{ "coordinate": { object ( |
الحقول | |
---|---|
coordinate
|
الإحداثيات التي يجب أن يبدأ إدراج البيانات عندها. |
data
|
البيانات المطلوب إدراجها. |
type
|
الطريقة التي يجب لصق البيانات بها. |
حقل الاتحاد
kind . كيفية تفسير البيانات، يجب تحديد قيمة واحدة بالضبط.
يمكن أن تكون السمة kind واحدًا فقط مما يلي:
|
|
delimiter
|
المحدد في البيانات. |
html
|
True إذا كانت البيانات HTML. |
TextToColumnsRequest
لتقسيم عمود من النص إلى أعمدة متعددة، استنادًا إلى محدِّد في كل خلية.
تمثيل JSON |
---|
{ "source": { object ( |
الحقول | |
---|---|
source
|
نطاق البيانات المصدر يجب أن يمتد هذا العمود إلى عمود واحد فقط. |
delimiter
|
المحدِّد المطلوب استخدامه. ولا يتم استخدامها إلا إذا كانت قيمة delimiterType هي
|
delimiterType
|
نوع المحدِّد المطلوب استخدامه. |
DelimiterType
المحدِّد المطلوب التقسيم بناءً عليه.
عمليات التعداد | |
---|---|
DELIMITER_TYPE_UNSPECIFIED
|
القيمة التلقائية. يجب عدم استخدام هذه القيمة. |
COMMA
|
"," |
SEMICOLON
|
";" |
PERIOD
|
"." |
SPACE
|
" " |
CUSTOM
|
قيمة مخصّصة كما هو محدّد في المحدِّد. |
AUTODETECT
|
اكتشاف الأعمدة تلقائيًا |
UpdateFilterViewRequest
يعدِّل خصائص عرض الفلتر.
تمثيل JSON |
---|
{
"filter": {
object (
|
الحقول | |
---|---|
filter
|
الخصائص الجديدة لعرض الفلتر. |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. الجذر |
DeleteRangeRequest
حذف نطاق من الخلايا، ونقل الخلايا الأخرى إلى المنطقة المحذوفة
تمثيل JSON |
---|
{ "range": { object ( |
الحقول | |
---|---|
range
|
نطاق الخلايا المطلوب حذفه. |
shiftDimension
|
البُعد الذي سيتم استبدال الخلايا المحذوفة منه. إذا
|
AppendDimensionRequest
لإلحاق صفوف أو أعمدة بنهاية الورقة.
تمثيل JSON |
---|
{
"sheetId": integer,
"dimension": enum (
|
الحقول | |
---|---|
sheetId
|
ورقة البيانات لإلحاق الصفوف أو الأعمدة بها. |
dimension
|
ما إذا كان يجب إلحاق الصفوف أو الأعمدة. |
length
|
عدد الصفوف أو الأعمدة المطلوب إلحاقها. |
AddConditionalFormatRuleRequest
لإضافة قاعدة تنسيق شرطي جديدة في الفهرس المحدّد. تتم زيادة فهارس القواعد اللاحقة.
تمثيل JSON |
---|
{
"rule": {
object (
|
الحقول | |
---|---|
rule
|
القاعدة المطلوب إضافتها. |
index
|
الفهرس المستند إلى صفر والذي يجب إدراج القاعدة فيه. |
UpdateConditionalFormatRuleRequest
لتعديل قاعدة تنسيق شرطي في الفهرس المحدّد، أو نقل قاعدة تنسيق شرطي إلى فهرس آخر.
تمثيل JSON |
---|
{ "index": integer, "sheetId": integer, // Union field |
الحقول | |
---|---|
index
|
الفهرس المستند إلى صفر للقاعدة التي يجب استبدالها أو نقلها. |
sheetId
|
ورقة القاعدة المطلوب نقلها. مطلوبة في حال ضبط
السمة |
حقل الاتحاد
instruction . نوع التحديث الذي يجب أن يحدث.
يمكن أن تكون السمة instruction واحدًا فقط مما يلي:
|
|
rule
|
القاعدة التي يجب أن تحل محل القاعدة في الفهرس المحدّد. |
newIndex
|
الفهرس الجديد المستند إلى الصفر الذي ينبغي أن تنتهي القاعدة فيه. |
DeleteConditionalFormatRuleRequest
لحذف قاعدة تنسيق شرطي في الفهرس المحدّد. يتم تقليل جميع فهارس القواعد اللاحقة.
تمثيل JSON |
---|
{ "index": integer, "sheetId": integer } |
الحقول | |
---|---|
index
|
فهرس القاعدة الصفرية للقاعدة المطلوب حذفها. |
sheetId
|
الورقة التي يتم حذف القاعدة منها. |
SortRangeRequest
يفرز البيانات في صفوف استنادًا إلى نظام الفرز لكل عمود.
تمثيل JSON |
---|
{ "range": { object ( |
الحقول | |
---|---|
range
|
النطاق المراد ترتيبه. |
sortSpecs[]
|
نظام الترتيب لكل عمود يتم استخدام المواصفات اللاحقة عندما تكون القيم متساوية في المواصفات السابقة. |
SetDataValidationRequest
لضبط قاعدة التحقق من صحة البيانات على كل خلية في النطاق. لمحو التحقق من الصحة في نطاق، استدعِ هذا بدون تحديد قاعدة.
تمثيل JSON |
---|
{ "range": { object ( |
الحقول | |
---|---|
range
|
النطاق الذي يجب أن تنطبق عليه قاعدة التحقّق من صحة البيانات. |
rule
|
قاعدة التحقق من صحة البيانات المراد تعيينها على كل خلية في النطاق، أو فارغة لمحو التحقق من صحة البيانات في النطاق. |
SetBasicFilterRequest
لضبط الفلتر الأساسي المرتبط بورقة.
تمثيل JSON |
---|
{
"filter": {
object (
|
الحقول | |
---|---|
filter
|
الفلتر المطلوب ضبطه. |
AddProtectedRangeRequest
لإضافة نطاق محمي جديد.
تمثيل JSON |
---|
{
"protectedRange": {
object (
|
الحقول | |
---|---|
protectedRange
|
النطاق المحمي المطلوب إضافته يُرجى العلم أنّ الحقل |
UpdateProtectedRangeRequest
تعمل هذه السياسة على تعديل نطاق محمي حالي باستخدام السمة protectedRangeId
المحدّدة.
تمثيل JSON |
---|
{
"protectedRange": {
object (
|
الحقول | |
---|---|
protectedRange
|
النطاق المحمي الذي سيتم تعديله باستخدام السمات الجديدة |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. الجذر |
DeleteProtectedRangeRequest
يؤدي هذا الإجراء إلى حذف النطاق المحمي الذي يتضمّن المعرّف المحدَّد.
تمثيل JSON |
---|
{ "protectedRangeId": integer } |
الحقول | |
---|---|
protectedRangeId
|
معرّف النطاق المحمي المطلوب حذفه. |
AutoResizeDimensionsRequest
يتم تلقائيًا تغيير حجم بُعد واحد أو أكثر استنادًا إلى محتوى الخلايا في هذا البُعد.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
dimension_range . نطاق السمات.
يمكن أن تكون السمة dimension_range واحدًا فقط مما يلي:
|
|
dimensions
|
الأبعاد التي سيتم تغيير حجمها تلقائيًا |
dataSourceSheetDimensions
|
الأبعاد في ورقة مصدر البيانات المطلوب تغيير حجمها تلقائيًا. |
AddChartRequest
لإضافة مخطط إلى ورقة في جدول البيانات.
تمثيل JSON |
---|
{
"chart": {
object (
|
الحقول | |
---|---|
chart
|
المخطط الذي يجب إضافته إلى جدول البيانات، بما في ذلك الموضع الذي يجب وضعه فيه. يُرجى العلم أنّ الحقل |
UpdateChartSpecRequest
لتعديل مواصفات الرسم البياني (لا يؤدي هذا إلى نقل الرسم البياني أو تغيير حجمه. لنقل رسم بياني أو تغيير حجمه، استخدِم
UpdateEmbeddedObjectPositionRequest
.)
تمثيل JSON |
---|
{
"chartId": integer,
"spec": {
object (
|
الحقول | |
---|---|
chartId
|
رقم تعريف الرسم البياني المطلوب تحديثه. |
spec
|
المواصفات المطلوب تطبيقها على الرسم البياني |
UpdateBandingRequest
يعدِّل خصائص النطاق المرتبط.
تمثيل JSON |
---|
{
"bandedRange": {
object (
|
الحقول | |
---|---|
bandedRange
|
النطاق النطاقي المطلوب تعديله بالخصائص الجديدة. |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. الجذر |
AddBandingRequest
لإضافة نطاق جديد بنطاق ترددي إلى جدول البيانات.
تمثيل JSON |
---|
{
"bandedRange": {
object (
|
الحقول | |
---|---|
bandedRange
|
النطاق النطاقات المطلوب إضافته. يُرجى العلم أنّ الحقل |
DeleteBandingRequest
يُزيل النطاق المرتبط بالمعرّف المحدّد من جدول البيانات.
تمثيل JSON |
---|
{ "bandedRangeId": integer } |
الحقول | |
---|---|
bandedRangeId
|
رقم تعريف النطاق النطاقي المطلوب حذفه. |
CreateDeveloperMetadataRequest
طلب لإنشاء البيانات الوصفية للمطوِّرين
تمثيل JSON |
---|
{
"developerMetadata": {
object (
|
الحقول | |
---|---|
developerMetadata
|
البيانات الوصفية لمطوّر البرامج المطلوب إنشاؤها |
UpdateDeveloperMetadataRequest
طلب لتعديل سمات البيانات الوصفية للمطوّرين يتم تعديل سمات البيانات الوصفية للمطوّرين التي اخترتها بواسطة الفلاتر إلى القيم المتوفرة في المورد DeveloperMetadata
. على المتصلين تحديد السمات التي يريدون تعديلها في معلَمة الحقول، بالإضافة إلى تحديد سمة DataFilter
واحدة على الأقل
مطابقة للبيانات الوصفية التي يريدون تعديلها.
تمثيل JSON |
---|
{ "dataFilters": [ { object ( |
الحقول | |
---|---|
dataFilters[]
|
الفلاتر التي تتطابق مع إدخالات البيانات الوصفية للمطوّرين المطلوب تعديلها |
developerMetadata
|
سيتم تعديل القيمة التي سيتم تعديل كل البيانات الوصفية المُطابِقة لفلاتر البيانات إليها. |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. الجذر |
DeleteDeveloperMetadataRequest
طلب لحذف البيانات الوصفية للمطوِّرين
تمثيل JSON |
---|
{
"dataFilter": {
object (
|
الحقول | |
---|---|
dataFilter
|
فلتر البيانات الذي يصف المعايير المستخدَمة لاختيار إدخال البيانات الوصفية للمطوِّر المطلوب حذفه. |
RandomizeRangeRequest
ترتيب الصفوف في نطاق عشوائيًا.
تمثيل JSON |
---|
{
"range": {
object (
|
الحقول | |
---|---|
range
|
النطاق المراد توزيعه عشوائيًا. |
AddDimensionGroupRequest
ينشئ مجموعة في النطاق المحدد.
إذا كان النطاق المطلوب عبارة عن مجموعة فرعية لنطاق المجموعة الحالية G، فسيزيد عمق G في هذه المجموعة الجديدة، ويكون لهذه المجموعة G عمقًا في هذه المجموعة. على سبيل المثال، ينتج عن المجموعة [C:D, العمق 1] + [B:E] المجموعتَين [B:E، العمق 1] و[C:D، العمق 2]. إذا كان النطاق المطلوب هو مجموعة فرعية من نطاق المجموعة الحالية G، فإن عمق المجموعة الجديدة G' يصبح أكبر من عمق G. على سبيل المثال، ينتج عن المجموعة [B:E، العمق 1] + [C:D] المجموعتَين [B:E، العمق 1] و[C:D، العمق 2]. إذا كان النطاق المطلوب يبدأ قبل وينتهي داخل نطاق المجموعة الحالية G وينتهي بعده أو يبدأ داخله وينتهي بعده، فإن نطاق المجموعة الحالية G يصبح اتحاد النطاقات، ويصبح عمق المجموعة الجديدة G عمقًا أكبر من عمق G ونطاق كتقاطع النطاقات. على سبيل المثال، ينتج عن المجموعة [B:D, العمق 1] + [C:E] المجموعتين [B:E، العمق 1] و[C:D، العمق 2].
تمثيل JSON |
---|
{
"range": {
object (
|
الحقول | |
---|---|
range
|
النطاق المراد إنشاء مجموعة عليه. |
DeleteDimensionGroupRequest
حذف مجموعة خلال النطاق المحدد من خلال تقليل عمق الأبعاد في النطاق
على سبيل المثال، لنفترض أنّ الورقة تحتوي على مجموعة عمق 1 في B:E ومجموعة depth-2 خلال C:D. يؤدي حذف مجموعة فوق D:E إلى ترك الورقة بمجموعة depth-1 على B:D ومجموعة depth-2 على C:C.
تمثيل JSON |
---|
{
"range": {
object (
|
الحقول | |
---|---|
range
|
نطاق المجموعة المراد حذفها. |
UpdateDimensionGroupRequest
تعمل على تعديل حالة المجموعة المحدّدة.
تمثيل JSON |
---|
{
"dimensionGroup": {
object (
|
الحقول | |
---|---|
dimensionGroup
|
المجموعة التي يجب تعديل حالتها. يجب أن يحدد نطاق المجموعة وعمقها مجموعة صالحة في ورقة البيانات، وسيتم تعديل جميع الحقول الأخرى. |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. الجذر |
TrimWhitespaceRequest
لاقتطاع المسافة البيضاء (مثل المسافات أو علامات التبويب أو الأسطر الجديدة) في كل خلية في النطاق المحدد يزيل هذا الطلب جميع المسافات البيضاء من بداية نص كل خلية ونهايته، ويقلل أي تسلسل فرعي من أحرف المسافة البيضاء المتبقية إلى مسافة واحدة. إذا كان النص المقتطع الناتج يبدأ بحرف "+" أو "='"، يظل النص كقيمة سلسلة ولن يتم تفسيره على أنه صيغة.
تمثيل JSON |
---|
{
"range": {
object (
|
الحقول | |
---|---|
range
|
النطاق الذي سيتم قطع الخلايا فيه. |
DeleteDuplicatesRequest
لإزالة الصفوف الموجودة في هذا النطاق والتي تحتوي على قيم في الأعمدة المحددة التي هي تكرارات لقيم في أي صف سابق. الصفوف التي تحتوي على قيم متطابقة ولكن حالات الأحرف أو التنسيقات أو الصيغ مختلفة تعتبر مكررة.
يؤدي هذا الطلب أيضًا إلى إزالة الصفوف المكرّرة التي تم إخفاؤها من العرض (بسبب فلتر على سبيل المثال). عند إزالة التكرارات، يتم الاحتفاظ بأول مثيل لكل مسح صف مكرر من أعلى لأسفل في النطاق الناتج. لا تتم إزالة المحتوى الذي يقع خارج النطاق المحدد، كما لا يجب أن تكون الصفوف التي تعتبر تكرارات متجاورة في النطاق.
تمثيل JSON |
---|
{ "range": { object ( |
الحقول | |
---|---|
range
|
النطاق المطلوب إزالة الصفوف المكرّرة منه. |
comparisonColumns[]
|
الأعمدة في النطاق المطلوب تحليلها بحثًا عن قيم مكرّرة. وإذا لم يتم تحديد أي أعمدة، سيتم تحليل جميع الأعمدة بحثًا عن أي أعمدة مكرّرة. |
UpdateEmbeddedObjectBorderRequest
لتحديث خاصية الحد في عنصر مضمّن.
تمثيل JSON |
---|
{
"objectId": integer,
"border": {
object (
|
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر المضمَّن المطلوب تعديله |
border
|
الحد الذي ينطبق على الكائن المضمن. |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. الجذر |
AddSlicerRequest
إضافة فلتر نطاق بيانات إلى ورقة في جدول البيانات
تمثيل JSON |
---|
{
"slicer": {
object (
|
الحقول | |
---|---|
slicer
|
فلتر نطاق البيانات الذي يجب إضافته إلى جدول البيانات، بما في ذلك الموضع الذي يجب وضعه فيه. يُرجى العلم أنّ الحقل |
UpdateSlicerSpecRequest
يعدِّل مواصفات فلتر نطاق بيانات. (لا يؤدي ذلك إلى نقل فلتر نطاق بيانات أو تغيير حجمه. لنقل فلتر نطاق بيانات أو تغيير حجمه، استخدِم
UpdateEmbeddedObjectPositionRequest
.
تمثيل JSON |
---|
{
"slicerId": integer,
"spec": {
object (
|
الحقول | |
---|---|
slicerId
|
رقم تعريف فلتر نطاق البيانات المطلوب تعديله. |
spec
|
المواصفات المطلوب تطبيقها على فلتر نطاق بيانات. |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. الجذر |
AddDataSourceRequest
لإضافة مصدر بيانات. بعد إضافة مصدر البيانات بنجاح، يتم إنشاء ورقة
DATA_SOURCE
مرتبطة يتم تشغيل عملية التنفيذ لإعادة تحميل ورقة البيانات لقراءة البيانات من مصدر البيانات. يتطلب الطلب نطاق bigquery.readonly
إضافيًا لبروتوكول OAuth.
تمثيل JSON |
---|
{
"dataSource": {
object (
|
الحقول | |
---|---|
dataSource
|
مصدر البيانات المطلوب إضافته. |
UpdateDataSourceRequest
لتعديل مصدر بيانات بعد تعديل مصدر البيانات بنجاح، يتم بدء تنفيذ لإعادة تحميل ورقة
DATA_SOURCE
المرتبطة لقراءة البيانات من مصدر البيانات المعدّل. يتطلب الطلب نطاق bigquery.readonly
إضافيًا لبروتوكول OAuth.
تمثيل JSON |
---|
{
"dataSource": {
object (
|
الحقول | |
---|---|
dataSource
|
مصدر البيانات المطلوب تعديله. |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. الجذر |
DeleteDataSourceRequest
لحذف مصدر بيانات. يؤدي الطلب أيضًا إلى حذف ورقة مصدر البيانات المرتبطة، وإلغاء ربط جميع عناصر مصدر البيانات المرتبطة بها.
تمثيل JSON |
---|
{ "dataSourceId": string } |
الحقول | |
---|---|
dataSourceId
|
رقم تعريف مصدر البيانات المطلوب حذفه. |
RefreshDataSourceRequest
لإعادة تحميل عنصر واحد أو أكثر من عناصر مصدر البيانات في جدول البيانات حسب المراجع المحدّدة. يتطلب الطلب نطاق bigquery.readonly
إضافيًا لبروتوكول OAuth.
في حال كانت هناك طلبات إعادة تحميل متعدّدة تشير إلى عناصر مصدر البيانات نفسها في دفعة واحدة، تتم معالجة آخر طلب إعادة تحميل فقط، وسيكون لجميع هذه الطلبات الاستجابة نفسها وفقًا لذلك.
تمثيل JSON |
---|
{ "force": boolean, // Union field |
الحقول | |
---|---|
force
|
إعادة تحميل عناصر مصدر البيانات بغضّ النظر عن الحالة الحالية إذا لم يتم ضبط السياسة وكان هناك عنصر مصدر بيانات مُشار إليه في حالة خطأ، ستتعذّر عملية إعادة التحميل على الفور. |
حقل الاتحاد
target . تُحدِّد العناصر التي تريد إعادة تحميلها.
يمكن أن تكون السمة target واحدًا فقط مما يلي:
|
|
references
|
المراجع إلى عناصر مصدر البيانات المطلوب إعادة تحميلها |
dataSourceId
|
الإشارة إلى |
isAll
|
إعادة تحميل كل كائنات مصدر البيانات الحالية في جدول البيانات. |
DataSourceObjectReferences
قائمة مراجع لعناصر مصدر البيانات.
تمثيل JSON |
---|
{
"references": [
{
object (
|
الحقول | |
---|---|
references[]
|
المراجع. |
DataSourceObjectReference
الإشارة إلى عنصر مصدر بيانات
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
value . نوع المرجع
يمكن أن تكون السمة value واحدًا فقط مما يلي:
|
|
sheetId
|
يشير إلى ورقة
|
chartId
|
يشير إلى مخطط مصدر بيانات. |
dataSourceTableAnchorCell
|
يشير إلى |
dataSourcePivotTableAnchorCell
|
يشير هذا المصطلح إلى إشارات إلى مصدر بيانات
|
dataSourceFormulaCell
|
يشير إلى خلية تحتوي على |
CancelDataSourceRefreshRequest
إلغاء عمليات إعادة تحميل واحدة أو أكثر لعناصر مصدر البيانات في جدول البيانات حسب المراجع المحدّدة
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
target . تحدِّد هذه السياسة ما يجب إلغاؤها.
يمكن أن تكون السمة target واحدًا فقط مما يلي:
|
|
references
|
يشير إلى عناصر مصدر البيانات التي سيتم إلغاء عمليات إعادة تحميلها. |
dataSourceId
|
الإشارة إلى |
isAll
|
يؤدي إلى إلغاء جميع عمليات إعادة تحميل عناصر مصدر البيانات الحالية لجميع مصادر البيانات في جدول البيانات. |