الطلب
نوع واحد من التحديثات لتطبيقه على جدول بيانات.
تمثيل 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 المرتبطة بها. |
طلب تعديل جدول البيانات
تعدِّل خصائص جدول البيانات.
تمثيل JSON |
---|
{
"properties": {
object (
|
الحقول | |
---|---|
properties
|
السمات المراد تعديلها. |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. الجذر "الخصائص" ضمنيًا ويجب عدم تحديده. يمكن استخدام
|
طلب تعديل خصائص الورقة
تعدِّل سمات جدول البيانات باستخدام السمة
sheetId
المحدَّدة.
تمثيل JSON |
---|
{
"properties": {
object (
|
الحقول | |
---|---|
properties
|
السمات المراد تعديلها. |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. إنّ الجذر |
طلب تعديل السمات
يعدّل خصائص الأبعاد ضمن النطاق المحدد.
تمثيل JSON |
---|
{ "properties": { object ( |
الحقول | |
---|---|
properties
|
المواقع المطلوب تعديلها |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. إنّ الجذر |
حقل الاتحاد
dimension_range . نطاق السمة.
يمكن أن تكون السمة dimension_range
واحدة فقط من العناصر التالية:
|
|
range
|
الصفوف أو الأعمدة المطلوب تعديلها. |
dataSourceSheetRange
|
الأعمدة في ورقة مصدر بيانات لتعديلها. |
سلسلة بيانات مصدر البيانات
نطاق على طول سمة واحدة في
ورقة DATA_SOURCE
.
تمثيل JSON |
---|
{
"sheetId": integer,
"columnReferences": [
{
object (
|
الحقول | |
---|---|
sheetId
|
رقم تعريف ورقة مصدر البيانات التي يحتوي عليها النطاق |
columnReferences[]
|
الأعمدة في ورقة بيانات المصدر. |
تحديثNameRanRanRequest
تعدِّل سمات النطاق المُعنوَن باستخدام
السمة namedRangeId
المحدّدة.
تمثيل JSON |
---|
{
"namedRange": {
object (
|
الحقول | |
---|---|
namedRange
|
النطاق المُعَدّل لتعديله باستخدام السمات الجديدة. |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. إنّ الجذر |
طلب تكرار الخلية
تحديث جميع الخلايا في النطاق إلى القيم في عنصر الخلية المحدّد. يتم تعديل الحقول المدرَجة في الحقل fields
فقط، ولا يتم تغيير الحقول الأخرى.
إذا كتبت خلية تحتوي على صيغة، ستزداد نطاقات الصيغ تلقائيًا لكل حقل في النطاق. على سبيل المثال، إذا كتبت خلية تحتوي على الصيغة =A1
في النطاق B2:C4، ستكون B2 =A1
، وستكون B3 هي =A2
، وB4 ستكون =A3
، وC2 هي =B2
، وC3 هي =B3
.=B1
للحفاظ على نطاق ثابت للصيغة، استخدِم مؤشر
$
. على سبيل المثال، استخدِم الصيغة
=$A$1
لمنع زيادة الصف والعمود.
تمثيل JSON |
---|
{ "range": { object ( |
الحقول | |
---|---|
range
|
النطاق لتكرار الخلية. |
cell
|
البيانات المطلوب كتابتها |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. إنّ الجذر |
طلب إضافة اسم الاسم
لإضافة نطاق مُعنوَن إلى جدول البيانات
تمثيل JSON |
---|
{
"namedRange": {
object (
|
الحقول | |
---|---|
namedRange
|
النطاق المُعنون. والحقل |
حذفNameNameRangeRequest
تزيل النطاق المُسمّى بالمعرف المحدد من جدول البيانات.
تمثيل JSON |
---|
{ "namedRangeId": string } |
الحقول | |
---|---|
namedRangeId
|
رقم تعريف النطاق المُعنوَن المراد حذفه |
طلب إضافة ورقة بيانات
لإضافة ورقة جديدة. عند إضافة ورقة بيانات في فهرس معيّن، تتم زيادة جميع فهارس جداول البيانات اللاحقة. لإضافة ورقة بيانات، استخدِم AddChartRequest
بدلاً من ذلك وحدِّد EmbeddedObjectPosition.sheetId
أو EmbeddedObjectPosition.newSheet
.
تمثيل JSON |
---|
{
"properties": {
object (
|
الحقول | |
---|---|
properties
|
الخصائص التي يجب أن تتضمنها الورقة الجديدة. وجميع السمات اختيارية. والحقل |
حذف طلب ورقة البيانات
حذف ورقة البيانات المطلوبة
تمثيل JSON |
---|
{ "sheetId": integer } |
الحقول | |
---|---|
sheetId
|
رقم تعريف ورقة البيانات التي سيتم حذفها
وإذا كانت ورقة البيانات من النوع
|
طلب الملء التلقائي
ملء المزيد من البيانات استنادًا إلى البيانات الحالية
تمثيل JSON |
---|
{ "useAlternateSeries": boolean, // Union field |
الحقول | |
---|---|
useAlternateSeries
|
صحيح إذا كان علينا إنشاء بيانات باستخدام السلسلة "البديلة". وتختلف هذه البيانات استنادًا إلى نوع البيانات المصدر ومقدارها. |
حقل الاتحاد
area . المنطقة المراد الملء التلقائي لها.
يمكن أن تكون السمة area
واحدة فقط من العناصر التالية:
|
|
range
|
النطاق المراد الملء التلقائي له. سيؤدي هذا إلى فحص النطاق واكتشاف الموقع الذي يحتوي على البيانات وملء هذه البيانات تلقائيًا ببقية النطاق. |
sourceAndDestination
|
منطقتا المصدر والوجهة للملء التلقائي. ويسرد هذا بوضوح مصدر الملء التلقائي ومكان تمديد تلك البيانات. |
SourceAndDestination
مزيج من نطاق المصدر وكيفية توسيع هذا المصدر
تمثيل JSON |
---|
{ "source": { object ( |
الحقول | |
---|---|
source
|
موقع البيانات المطلوب استخدامها كمصدر للملء التلقائي. |
dimension
|
السمة التي يجب ملء البيانات فيها |
fillLength
|
عدد الصفوف أو الأعمدة التي يجب ملء البيانات فيها يتم توسيع الأرقام الموجبة خارج الصف الأخير أو العمود الأخير للمصدر. يتم توسيع الأرقام السلبية قبل الصف الأول أو العمود الأول للمصدر. |
قص ولصق الطلب
تنقل البيانات من المصدر إلى الوجهة.
تمثيل JSON |
---|
{ "source": { object ( |
الحقول | |
---|---|
source
|
البيانات المصدر التي سيتم اقتصاصها |
destination
|
الإحداثيات الموجودة في أعلى يمين الشاشة حيث يجب لصق البيانات. |
pasteType
|
نوع البيانات التي سيتم لصقها سيتم اقتصاص جميع البيانات المصدر، بغض النظر عن ما تم لصقه. |
نوع اللصق
نوع البيانات التي يجب لصقها
عمليات التعداد | |
---|---|
PASTE_NORMAL
|
لصق القيم والصيغ والتنسيقات وعمليات الدمج |
PASTE_VALUES
|
الصق القيم فقط بدون التنسيقات أو الصِيَغ أو عمليات الدمج. |
PASTE_FORMAT
|
لصق التنسيق والتحقّق من صحة البيانات فقط |
PASTE_NO_BORDERS
|
مثل PASTE_NORMAL
ولكن بدون حدود.
|
PASTE_FORMULA
|
لصق الصيغ فقط. |
PASTE_DATA_VALIDATION
|
لصق التحقق من صحة البيانات فقط |
PASTE_CONDITIONAL_FORMATTING
|
لصق قواعد التنسيق الشرطي فقط. |
نسخ طلب اللصق
نسخ البيانات من المصدر إلى الوجهة
تمثيل JSON |
---|
{ "source": { object ( |
الحقول | |
---|---|
source
|
النطاق المصدر المراد نسخه. |
destination
|
الموقع الجغرافي الذي سيتم لصق العناصر فيه. إذا كان النطاق يشمل امتدادًا مضاعفًا من ارتفاع المصدر أو عرضه، سيتم تكرار البيانات لملء نطاق الوجهة. إذا كان النطاق أصغر من النطاق المصدر، سيستمر نسخ بيانات المصدر بالكامل (بعد نهاية نطاق الوجهة). |
pasteType
|
نوع البيانات التي سيتم لصقها |
pasteOrientation
|
كيف يجب أن تكون هذه البيانات موجّهة عند اللصق؟ |
لصق الاتجاه
كيفية إجراء عملية اللصق.
عمليات التعداد | |
---|---|
NORMAL
|
لصق المحتوى بشكل طبيعي: |
TRANSPOSE
|
تم لصق المحوِّل، حيث تتحوّل جميع الصفوف إلى أعمدة والعكس صحيح. |
طلب دمج الخلايا
تدمج جميع الخلايا في النطاق
تمثيل JSON |
---|
{ "range": { object ( |
الحقول | |
---|---|
range
|
نطاق الخلايا المراد دمجه. |
mergeType
|
كيفية دمج الخلايا |
نوع الدمج
نوع الدمج المراد إنشاؤه.
عمليات التعداد | |
---|---|
MERGE_ALL
|
إنشاء عملية دمج واحدة من النطاق |
MERGE_COLUMNS
|
إنشاء عملية دمج لكل عمود في النطاق |
MERGE_ROWS
|
إنشاء عملية دمج لكل صف في النطاق |
إلغاء دمج الخلايا
إلغاء دمج الخلايا في النطاق المحدّد
تمثيل JSON |
---|
{
"range": {
object (
|
الحقول | |
---|---|
range
|
النطاق الذي يجب أن يتم إلغاء دمج كل الخلايا فيه وإذا شمل النطاق عمليات دمج متعدّدة، سيتم إلغاء دمج كل عمليات الدمج. يجب ألا يمتد النطاق جزئيًا إلى أي دمج. |
طلب تعديل الحدود
تعدِّل حدود نطاق ما. في حال عدم ضبط حقل في الطلب، يعني ذلك أنّ الحدود ستظل كما هي. على سبيل المثال، مع تحديثَي 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
|
الحد الرأسي لوضعه داخل النطاق. |
تعديل الخلايا
تعدِّل جميع الخلايا في نطاق باستخدام بيانات جديدة.
تمثيل JSON |
---|
{ "rows": [ { object ( |
الحقول | |
---|---|
rows[]
|
البيانات المطلوب كتابتها |
fields
|
حقول بيانات شبكة الجوّال التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. الجذر هو CellularData، ويجب عدم تحديد "صف." يمكن استخدام
|
حقل الاتحاد
area . يجب كتابة بيانات الموقع الجغرافي. يجب ضبط قيمة واحدة بالضبط.
يمكن أن تكون السمة area
واحدة فقط من العناصر التالية:
|
|
start
|
التنسيق المطلوب لبدء كتابة البيانات على يمكن كتابة أي عدد من الصفوف والأعمدة (بما في ذلك عدد مختلف من الأعمدة لكل صف). |
range
|
النطاق المراد كتابة البيانات فيه.
إذا كانت البيانات في الصفوف لا تغطي النطاق المطلوب بالكامل، سيتم محو الحقول التي تطابق تلك المحدّدة في
|
إضافة طلب عرض الفلتر
لإضافة عرض فلتر.
تمثيل JSON |
---|
{
"filter": {
object (
|
الحقول | |
---|---|
filter
|
الفلتر المطلوب إضافته والحقل |
ملحق الخلايا
لإضافة خلايا جديدة بعد الصف الأخير مع بيانات في ورقة، مع إدراج صفوف جديدة في ورقة البيانات إذا لزم الأمر.
تمثيل JSON |
---|
{
"sheetId": integer,
"rows": [
{
object (
|
الحقول | |
---|---|
sheetId
|
رقم تعريف ورقة البيانات لإلحاق البيانات بها |
rows[]
|
البيانات المطلوب إلحاقها. |
fields
|
حقول بيانات شبكة الجوّال التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. الجذر هو CellularData، ويجب عدم تحديد "صف." يمكن استخدام
|
طلب_محو_الفلتر الأساسي
لمحو الفلتر الأساسي، في حال توفّره.
تمثيل JSON |
---|
{ "sheetId": integer } |
الحقول | |
---|---|
sheetId
|
رقم تعريف الورقة الذي يجب محو الفلتر الأساسي عليه. |
حذف طلب
يؤدي إلى حذف السمات من الورقة.
تمثيل JSON |
---|
{
"range": {
object (
|
الحقول | |
---|---|
range
|
الأبعاد المطلوب حذفها من ورقة البيانات. |
حذف،ObjectObjectRequest
حذف العنصر المضمّن باستخدام المعرّف المحدّد
تمثيل JSON |
---|
{ "objectId": integer } |
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر المضمّن المطلوب حذفه |
حذف RequestViewView
حذف عرض فلتر معيّن
تمثيل JSON |
---|
{ "filterId": integer } |
الحقول | |
---|---|
filterId
|
رقم تعريف الفلتر المطلوب حذفه |
طلب عرض مكرر
تكرار عرض فلتر معيّن
تمثيل JSON |
---|
{ "filterId": integer } |
الحقول | |
---|---|
filterId
|
رقم تعريف الفلتر المكرّر |
طلب نسخة طبق الأصل
تكرار محتوى ورقة البيانات.
تمثيل JSON |
---|
{ "sourceSheetId": integer, "insertSheetIndex": integer, "newSheetId": integer, "newSheetName": string } |
الحقول | |
---|---|
sourceSheetId
|
الورقة مكررة.
إذا كانت ورقة البيانات المصدر من النوع
|
insertSheetIndex
|
الفهرس المستند إلى الصفر حيث يجب إدراج الورقة الجديدة. تتم زيادة فهرس جميع جداول البيانات بعد ذلك. |
newSheetId
|
في حال ضبطها، رقم تعريف ورقة البيانات الجديدة. وفي حال عدم ضبطها، يتم اختيار معرّف. وإذا تم ضبطه، يجب ألا يتعارض رقم التعريف مع أي رقم تعريف حالي للأوراق. ويجب ضبط هذه السياسة بدون قيمة سالبة إذا تم ضبطها. |
newSheetName
|
اسم ورقة البيانات الجديدة. إذا كان الحقل فارغًا، يتم اختيار اسم جديد لك. |
طلب الاستبدال
يبحث عن البيانات في الخلايا ويستبدلها فوق نطاق أو جدول بيانات أو جميع الأوراق.
تمثيل JSON |
---|
{ "find": string, "replacement": string, "matchCase": boolean, "matchEntireCell": boolean, "searchByRegex": boolean, "includeFormulas": boolean, // Union field |
الحقول | |
---|---|
find
|
القيمة المراد البحث عنها. |
replacement
|
القيمة المراد استخدامها كبديل. |
matchCase
|
صحيح إذا كانت عملية البحث حسّاسة لحالة الأحرف. |
matchEntireCell
|
صحيح إذا كانت قيمة البحث يجب أن تتطابق مع الخلية بأكملها. |
searchByRegex
|
صحيح إذا كانت قيمة البحث هي regex. يجب أن يتبع التعبير العادي والاستبدال العادي قواعد regex في Java على
https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html. يُسمح لسلسلة الاستبدال بالرجوع إلى مجموعات الالتقاط. على سبيل المثال، إذا كانت خلية تحتوي على محتوى
|
includeFormulas
|
صحيح إذا كان البحث يجب أن يتضمن خلايا ذات صيغ. خطأ لتخطّي الخلايا التي تحتوي على صيغ. |
حقل الاتحاد
scope . النطاق الذي يمكن العثور عليه/استبداله، يجب ضبط نطاق واحد فقط.
يمكن أن تكون السمة scope
واحدة فقط من العناصر التالية:
|
|
range
|
النطاق المراد البحث عنه/استبداله. |
sheetId
|
ورقة البيانات للعثور عليها أو استبدالها. |
allSheets
|
صحيح للعثور على/استبدال جميع الأوراق. |
طلب الإدراج
إدراج صفوف أو أعمدة في ورقة في فهرس معيّن.
تمثيل JSON |
---|
{
"range": {
object (
|
الحقول | |
---|---|
range
|
السمات التي سيتم إدراجها. يجب أن يكون كلا فهرسَي البداية والنهاية مرتبطَين. |
inheritFromBefore
|
ما إذا كان يجب توسيع سمات الأبعاد من السمات قبل أو بعد السمات التي تم إدراجها حديثًا. صحيح حتى يتم اكتسابها من الأبعاد السابقة (في هذه الحالة يجب أن يكون فهرس البدء أكبر من 0)، وعلى خطأ حتى يتم اكتسابها من الأبعاد بعد ذلك.
على سبيل المثال، إذا كان فهرس الصف 0 يتميز بخلفية حمراء وفهرس الصف 1 له خلفية خضراء، يمكن أن يدرج إدراج صفين في الفهرس 1 الخلفية الخضراء أو الحمراء. وإذا كانت السياسة |
طلب الإدراج
إدخال خلايا في نطاق، مع نقل الخلايا الحالية إلى الأعلى أو الأسفل
تمثيل JSON |
---|
{ "range": { object ( |
الحقول | |
---|---|
range
|
النطاق المراد إدراج خلايا جديدة فيه. |
shiftDimension
|
البُعد الذي سيتم تحويله عند إدراج الخلايا. إذا
|
طلب البُعد
نقل صف أو عمود واحد أو أكثر.
تمثيل JSON |
---|
{
"source": {
object (
|
الحقول | |
---|---|
source
|
سمات المصدر المراد نقلها |
destinationIndex
|
فهرس البدء المستند إلى الصفر للمكان الذي سيتم نقل بيانات المصدر إليه، استنادًا إلى الإحداثيات قبل إزالة بيانات المصدر من الشبكة سيتم نقل البيانات الحالية للأسفل أو لليمين (بناءً على السمة) لتوفير مساحة للسمات التي تم نقلها. تتم إزالة أبعاد المصدر من الشبكة، لذا قد ينتهي ظهور البيانات في فهرس مختلف عن القيمة المحدّدة.
على سبيل المثال، في ظل
|
تعديلطلب IncludeObjectPositionRequest
تعديل موضع عنصر مضمَّن (مثل تحريك رسم بياني أو تغيير حجمه)
تمثيل JSON |
---|
{
"objectId": integer,
"newPosition": {
object (
|
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر الذي تم نقله |
newPosition
|
موضع صريح لنقل العنصر المضمّن إليه. في حال ضبط
|
fields
|
حقول
|
لصق بيانات
إدخال البيانات في جدول البيانات بدءًا من الإحداثيات المحددة.
تمثيل JSON |
---|
{ "coordinate": { object ( |
الحقول | |
---|---|
coordinate
|
الإحداثيات التي يجب أن يبدأ إدراج البيانات بها. |
data
|
البيانات المطلوب إدخالها. |
type
|
كيفية لصق البيانات |
حقل الاتحاد
kind . كيفية تفسير البيانات، يجب ضبط قيمة واحدة بالضبط.
يمكن أن تكون السمة kind
واحدة فقط من العناصر التالية:
|
|
delimiter
|
المُحدِّد في البيانات. |
html
|
صحيح إذا كانت البيانات بتنسيق HTML. |
طلب النص إلى الأعمدة
لتقسيم عمود من النص إلى أعمدة متعددة، استنادًا إلى محدِّد في كل خلية.
تمثيل JSON |
---|
{ "source": { object ( |
الحقول | |
---|---|
source
|
نطاق البيانات المصدر ويجب أن يتضمّن ذلك عمودًا واحدًا بالضبط. |
delimiter
|
المُحدِّد المستخدم. لا تُستخدم هذه السياسة إلا إذا كانت قيمة delimiterType
هي |
delimiterType
|
نوع المُحدِّد المطلوب استخدامه. |
نوع المُحدِّد
المُحدِّد للتقسيم عليه.
عمليات التعداد | |
---|---|
DELIMITER_TYPE_UNSPECIFIED
|
القيمة التلقائية يجب عدم استخدام هذه القيمة. |
COMMA
|
"," |
SEMICOLON
|
";" |
PERIOD
|
"." |
SPACE
|
" |
CUSTOM
|
قيمة مخصّصة كما هو محدّد في المُحدِّد. |
AUTODETECT
|
اكتشاف الأعمدة تلقائيًا |
تعديلطلب الفلتر
يتم تعديل خصائص عرض الفلتر.
تمثيل JSON |
---|
{
"filter": {
object (
|
الحقول | |
---|---|
filter
|
السمات الجديدة في عرض الفلتر. |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. إنّ الجذر |
طلب حذف النطاق
حذف نطاق من الخلايا، مع نقل الخلايا الأخرى إلى المنطقة المحذوفة
تمثيل JSON |
---|
{ "range": { object ( |
الحقول | |
---|---|
range
|
نطاق الخلايا المراد حذفه |
shiftDimension
|
البُعد الذي سيتم استبدال الخلايا المحذوفة منه. إذا
|
طلب الملحق
لإلحاق صفوف أو أعمدة بنهاية ورقة بيانات
تمثيل JSON |
---|
{
"sheetId": integer,
"dimension": enum (
|
الحقول | |
---|---|
sheetId
|
ورقة البيانات لإلحاق الصفوف أو الأعمدة بها. |
dimension
|
ما إذا كان يجب إلحاق الصفوف أو الأعمدة. |
length
|
عدد الصفوف أو الأعمدة المطلوب إلحاقها. |
AddConditionalFormatRuleRequest
لإضافة قاعدة تنسيق شرطي جديدة في الفهرس المحدد. تتم زيادة جميع فهارس القواعد اللاحقة.
تمثيل JSON |
---|
{
"rule": {
object (
|
الحقول | |
---|---|
rule
|
القاعدة المراد إضافتها. |
index
|
الفهرس القائم على الصفر حيث يجب إدراج القاعدة. |
تعديل الشرط الشرطيالطلب
يتم تعديل قاعدة التنسيق الشرطي في الفهرس المحدَّد أو نقل قاعدة تنسيق شرطي إلى فهرس آخر.
تمثيل JSON |
---|
{ "index": integer, "sheetId": integer, // Union field |
الحقول | |
---|---|
index
|
فهرس الصفر المستند إلى القاعدة التي يجب استبدالها أو نقلها. |
sheetId
|
ورقة القاعدة المراد نقلها. مطلوبة إذا تم ضبط السياسة |
حقل الاتحاد
instruction . نوع التحديث الذي يجب أن يحدث.
يمكن أن تكون السمة instruction
واحدة فقط من العناصر التالية:
|
|
rule
|
القاعدة التي يجب أن تحل محل القاعدة في الفهرس المحدّد. |
newIndex
|
الفهرس الجديد المستند إلى الصفر يجب أن تنتهي القاعدة فيه. |
DeleteConditionalFormatRuleRequest
حذف قاعدة تنسيق شرطي في الفهرس المحدد يتم تقليل كل فهارس القواعد اللاحقة.
تمثيل JSON |
---|
{ "index": integer, "sheetId": integer } |
الحقول | |
---|---|
index
|
فهرس صفري للقاعدة المطلوب حذفها |
sheetId
|
ورقة البيانات التي يتم حذف القاعدة منها. |
طلب الترتيب
لترتيب البيانات في صفوف بناءً على ترتيب الترتيب لكل عمود.
تمثيل JSON |
---|
{ "range": { object ( |
الحقول | |
---|---|
range
|
النطاق المراد ترتيبه. |
sortSpecs[]
|
نظام الترتيب لكل عمود. تُستخدم المواصفات لاحقًا عندما تكون القيم تساوي المواصفات السابقة. |
طلب SetDatavalidation
لضبط قاعدة التحقق من صحة البيانات لكل خلية في النطاق. لمحو التحقق من صحة نطاق، يمكنك استدعاء هذا الإجراء بدون تحديد قاعدة.
تمثيل JSON |
---|
{ "range": { object ( |
الحقول | |
---|---|
range
|
النطاق الذي يجب أن تنطبق عليه قاعدة التحقق من البيانات. |
rule
|
قاعدة التحقق من صحة البيانات التي تم ضبطها في كل خلية في النطاق أو فارغة لمحو محو التحقُّق من صحة النطاق في النطاق. |
طلب ضبط الفلتر الأساسي
يتم ضبط الفلتر الأساسي المرتبط بورقة بيانات.
تمثيل JSON |
---|
{
"filter": {
object (
|
الحقول | |
---|---|
filter
|
الفلتر الذي يمكن ضبطه |
طلب إضافة ProtectProtectedRange
لإضافة نطاق محمي جديد
تمثيل JSON |
---|
{
"protectedRange": {
object (
|
الحقول | |
---|---|
protectedRange
|
النطاق المحمي الذي ستتم إضافته. والحقل |
تحديث RequestProtectedRange
يعدّل نطاقًا محميًا حاليًا باستخدام
protectedRangeId
المحدّد.
تمثيل JSON |
---|
{
"protectedRange": {
object (
|
الحقول | |
---|---|
protectedRange
|
النطاق المحمي المطلوب تعديله باستخدام السمات الجديدة. |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. إنّ الجذر |
حذف RequestProtectedRange
حذف النطاق المحمي برقم التعريف المحدّد.
تمثيل JSON |
---|
{ "protectedRangeId": integer } |
الحقول | |
---|---|
protectedRangeId
|
رقم تعريف النطاق المحمي المطلوب حذفه |
طلب تغيير الحجم التلقائي
يتم تغيير حجم بُعد واحد أو أكثر تلقائيًا استنادًا إلى محتوى الخلايا في هذه السمة.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
dimension_range . نطاق السمة.
يمكن أن تكون السمة dimension_range
واحدة فقط من العناصر التالية:
|
|
dimensions
|
السمات التي سيتم تغيير حجمها تلقائيًا. |
dataSourceSheetDimensions
|
الأبعاد في ورقة بيانات المصدر لتغيير الحجم تلقائيًا. |
طلب إضافة رسم بياني
لإضافة رسم بياني إلى ورقة بيانات في جدول البيانات.
تمثيل JSON |
---|
{
"chart": {
object (
|
الحقول | |
---|---|
chart
|
الرسم البياني الذي يجب إضافته إلى جدول البيانات، بما في ذلك الموضع الذي يجب وضعه فيه والحقل |
طلب تعديل الرسم البياني
تعدِّل مواصفات الرسم البياني. (لا يؤدي هذا إلى نقل رسم بياني أو تغيير حجمه. لنقل رسم بياني أو تغيير حجمه، استخدِم UpdateEmbeddedObjectPositionRequest
.)
تمثيل JSON |
---|
{
"chartId": integer,
"spec": {
object (
|
الحقول | |
---|---|
chartId
|
رقم تعريف الرسم البياني الذي سيتم تعديله. |
spec
|
تمثّل هذه السمة المواصفات التي سيتم تطبيقها على الرسم البياني. |
تعديل طلب الحظر
تعدِّل خصائص النطاق المتعدد المُزوَّد.
تمثيل JSON |
---|
{
"bandedRange": {
object (
|
الحقول | |
---|---|
bandedRange
|
النطاق المعدَّل المراد تعديله باستخدام السمات الجديدة. |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. إنّ الجذر |
طلب إضافة حظر
لإضافة نطاق بنطاق جديد إلى جدول البيانات
تمثيل JSON |
---|
{
"bandedRange": {
object (
|
الحقول | |
---|---|
bandedRange
|
النطاق المقيّد لإضافته. والحقل |
حذف طلب حظر
يؤدي هذا الإجراء إلى إزالة النطاق المنقول باستخدام المعرّف المحدد من جدول البيانات.
تمثيل JSON |
---|
{ "bandedRangeId": integer } |
الحقول | |
---|---|
bandedRangeId
|
رقم تعريف النطاق المُعدَّل لحذفه |
إنشاء بيانات وصفية لمطوّر البرامج
طلب لإنشاء البيانات الوصفية لمطوّر البرامج.
تمثيل JSON |
---|
{
"developerMetadata": {
object (
|
الحقول | |
---|---|
developerMetadata
|
البيانات الوصفية لمطوّر البرامج المراد إنشاؤها. |
طلب إضافة بيانات وصفية لمطوّر البرامج
طلب تعديل خصائص البيانات الوصفية لمطوّر البرامج. يتم تعديل خصائص البيانات الوصفية لمطوّر البرامج التي اخترتها الفلاتر على القيم المقدّمة في المورد DeveloperMetadata
. وعلى المتصلين تحديد السمات التي يريدون تعديلها في معلَمة الحقول، بالإضافة إلى تحديد سمة DataFilter
واحدة على الأقل تتطابق مع البيانات الوصفية التي يريدون تعديلها.
تمثيل JSON |
---|
{ "dataFilters": [ { object ( |
الحقول | |
---|---|
dataFilters[]
|
الفلاتر التي تتطابق مع إدخالات البيانات الوصفية لمطوّر البرامج لإجراء التحديث. |
developerMetadata
|
وسيتم تعديل القيمة التي تتطابق معها جميع البيانات الوصفية وفقًا لفلاتر البيانات. |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. إنّ الجذر |
حذف البيانات الوصفية لمطوّر البرامج
طلب حذف البيانات الوصفية لمطوّر البرامج
تمثيل JSON |
---|
{
"dataFilter": {
object (
|
الحقول | |
---|---|
dataFilter
|
فلتر البيانات الذي يصف المعايير المستخدمة لاختيار إدخال البيانات الوصفية لمطوّر البرامج المراد حذفه. |
ترتيب عشوائي لطلب البحث
توزيع ترتيب الصفوف في نطاق عشوائيًا.
تمثيل JSON |
---|
{
"range": {
object (
|
الحقول | |
---|---|
range
|
النطاق العشوائي. |
طلب إضافة مجموعة
تنشئ هذه السياسة مجموعة عبر النطاق المحدّد.
إذا كان النطاق المطلوب يمثل نطاقًا واسعًا من نطاق مجموعة حالية، تتم زيادة عمق G لهذه المجموعة الجديدة التي لها عمق تلك المجموعة. على سبيل المثال، تؤدي المجموعة [C:D، العمق 1] + [B:E] إلى المجموعات [B:E، العمق 1] و[C:D، العمق 2]. إذا كان النطاق المطلوب هو مجموعة فرعية من نطاق مجموعة G حالية، يصبح عمق المجموعة G الجديدة أكبر من عمق G. على سبيل المثال، تؤدي المجموعة [B:E, depth 1] + [C:D] إلى مجموعتَين [B:E, depth 1] و[C:D, depth 2]. إذا كان النطاق المطلوب يبدأ قبل وينتهي داخل أو يبدأ بعد هذا النطاق وينتهي بعده، يصبح نطاق المجموعة الحالية G اتحاد النطاقات، ويصبح المجموعة G الجديدة عمقًا أكبر من عمق G والنطاق تقاطعًا للنطاقات. على سبيل المثال، المجموعة [B:D, depth 1] + [C:E] تؤدي إلى المجموعتَين [B:E, depth 1] و[C:D, depth 2].
تمثيل JSON |
---|
{
"range": {
object (
|
الحقول | |
---|---|
range
|
النطاق الذي يمكنك استخدامه لإنشاء مجموعة. |
حذف مجموعة المجموعة
حذف مجموعة من النطاق المحدّد عن طريق تقليل عمق السمات في النطاق.
على سبيل المثال، لنفترض أن ورقة البيانات تحتوي على مجموعة العمق 1 على الوضع B:E ومجموعة العمق 2 على C:D. يؤدي حذف مجموعة على D:E إلى مغادرة جدول البيانات الذي يتضمّن مجموعة عمقها 1-على B:D ومجموعة ذات العمق 2-C:C.
تمثيل JSON |
---|
{
"range": {
object (
|
الحقول | |
---|---|
range
|
نطاق المجموعة المراد حذفها. |
تعديل طلب مجموعة
تعدِّل حالة المجموعة المحدَّدة.
تمثيل JSON |
---|
{
"dimensionGroup": {
object (
|
الحقول | |
---|---|
dimensionGroup
|
المجموعة التي يجب تعديل حالتها. يجب أن يحدد نطاق وعمق المجموعة مجموعة صالحة في ورقة البيانات ويتم تعديل جميع الحقول الأخرى. |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. إنّ الجذر |
طلب القطع بالأبيض
قطع المسافة البيضاء (مثل المسافات أو علامات التبويب أو الأسطر الجديدة) في كل خلية في النطاق المحدّد يزيل هذا الطلب جميع المسافات البيضاء من بداية نص كل خلية ونهايته، ويقلل أي تسلسل لاحق لأحرف المسافة البيضاء المتبقية إلى مسافة واحدة. إذا كان النص المقتطع يبدأ بـ "+" أو "='"، يظل النص كقيمة سلسلة ولا يتم تفسيره كصيغة.
تمثيل JSON |
---|
{
"range": {
object (
|
الحقول | |
---|---|
range
|
النطاق الذي تريد قطع خلاياه |
حذف الأموال المكررة
يزيل الصفوف ضمن هذا النطاق الذي يتضمن قيمًا في الأعمدة المحددة تكرارًا للقيم في أي صف سابق. الصفوف التي تحتوي على قيم متطابقة ولكن حالات الأحرف أو التنسيقات أو الصيغ مختلفة تعتبر تكرارات.
يؤدي هذا الطلب أيضًا إلى إزالة الصفوف المكررة المخفية من العرض (على سبيل المثال، بسبب فلتر). عند إزالة النُسخ المكرّرة، يتم الاحتفاظ بالمثال الأول لكل عملية مسح صف مكرّرة من الأعلى للأسفل في النطاق الناتج. لا تتم إزالة المحتوى خارج النطاق المحدّد، كما لا يلزم أن تكون الصفوف التي تعتبر تكرارًا بجوار بعضها البعض في النطاق.
تمثيل JSON |
---|
{ "range": { object ( |
الحقول | |
---|---|
range
|
النطاق المطلوب إزالة الصفوف المكرّرة منه. |
comparisonColumns[]
|
الأعمدة في النطاق الذي سيتم تحليله بحثًا عن القيم المكرّرة. وفي حال عدم اختيار أي أعمدة، سيتم تحليل جميع الأعمدة بحثًا عن التكرارات. |
تعديل RequestObjectBorderRequest المُضمَّن
تعدِّل هذه السمة سمة الحدود للعنصر المضمَّن.
تمثيل JSON |
---|
{
"objectId": integer,
"border": {
object (
|
الحقول | |
---|---|
objectId
|
رقم تعريف العنصر المضمّن المراد تعديله |
border
|
الحد الذي ينطبق على العنصر المضمّن. |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. إنّ الجذر |
طلب إضافة
إضافة فلتر نطاق بيانات إلى ورقة بيانات في جدول البيانات
تمثيل JSON |
---|
{
"slicer": {
object (
|
الحقول | |
---|---|
slicer
|
فلتر نطاق البيانات الذي يجب إضافته إلى جدول البيانات، بما في ذلك الموضع الذي يجب وضعه فيه والحقل |
تعديلSlicerspecRequest
تعدِّل مواصفات فلتر نطاق البيانات. (لا يؤدي هذا إلى نقل فلتر نطاق البيانات أو تغيير حجمه. لنقل فلتر نطاق البيانات أو تغيير حجمه، استخدِم
UpdateEmbeddedObjectPositionRequest
.
تمثيل JSON |
---|
{
"slicerId": integer,
"spec": {
object (
|
الحقول | |
---|---|
slicerId
|
معرّف فلتر نطاق البيانات المراد تعديله |
spec
|
المواصفات التي سيتم تطبيقها على فلتر نطاق البيانات. |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. إنّ الجذر |
طلب مصدر البيانات
لإضافة مصدر بيانات بعد إضافة مصدر البيانات بنجاح، يتم إنشاء ورقة DATA_SOURCE
مرتبطة ويتم تشغيل عملية تنفيذ إعادة تحميل الورقة لقراءة البيانات من مصدر البيانات. يتطلب الطلب نطاق OAuth
إضافيًا
bigquery.readonly
.
تمثيل JSON |
---|
{
"dataSource": {
object (
|
الحقول | |
---|---|
dataSource
|
مصدر البيانات المطلوب إضافته |
تعديل مصدر البيانات
يتم تعديل مصدر البيانات. بعد تعديل مصدر البيانات بنجاح، يتم تنفيذ عملية إعادة تحميل ورقة البيانات DATA_SOURCE
المرتبطة لقراءة البيانات من مصدر البيانات المعدّل. يتطلب الطلب نطاق OAuth
إضافيًا
bigquery.readonly
.
تمثيل JSON |
---|
{
"dataSource": {
object (
|
الحقول | |
---|---|
dataSource
|
مصدر البيانات المطلوب تعديله |
fields
|
الحقول التي يجب تعديلها. يجب تحديد حقل واحد على الأقل. إنّ الجذر |
حذف بيانات المصدر
حذف مصدر بيانات ويحذف الطلب أيضًا ورقة بيانات المصدر المرتبط، ويلغي ربط جميع عناصر مصدر البيانات المرتبطة.
تمثيل JSON |
---|
{ "dataSourceId": string } |
الحقول | |
---|---|
dataSourceId
|
رقم تعريف مصدر البيانات المراد حذفه |
طلب إعادة تحميل البيانات المصدر
تتم إعادة تحميل عنصر واحد أو أكثر من عناصر مصدر البيانات في جدول البيانات من خلال المراجع المحدّدة. يتطلب الطلب نطاق OAuth
إضافيًا
bigquery.readonly
.
إذا كانت هناك عدّة طلبات إعادة تحميل تشير إلى عناصر مصدر البيانات نفسها في مجموعة واحدة، ستتم معالجة طلب إعادة التحميل الأخير فقط، وسيكون لجميع هذه الطلبات الاستجابة نفسها وفقًا لذلك.
تمثيل JSON |
---|
{ "force": boolean, // Union field |
الحقول | |
---|---|
force
|
يؤدي إلى إعادة تحميل عناصر مصدر البيانات بغض النظر عن الحالة الحالية. في حال عدم ضبط هذه السياسة وكانت حالة مصدر البيانات المُشار إليه في حالة خطأ، لن تنجح عملية إعادة التحميل على الفور. |
حقل الاتحاد
target . يحدّد هذا الإعداد العناصر التي يجب إعادة تحميلها.
يمكن أن تكون السمة target
واحدة فقط من العناصر التالية:
|
|
references
|
مراجع لعناصر مصدر البيانات لإعادة تحميلها |
dataSourceId
|
الإشارة إلى
|
isAll
|
إعادة تحميل جميع عناصر مصدر البيانات الحالية في جدول البيانات |
مراجع البيانات
قائمة بالإشارات إلى عناصر مصدر البيانات
تمثيل JSON |
---|
{
"references": [
{
object (
|
الحقول | |
---|---|
references[]
|
المراجع |
مصدر البيانات
الإشارة إلى عنصر مصدر بيانات
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد
value . نوع المرجع
يمكن أن تكون السمة value
واحدة فقط من العناصر التالية:
|
|
sheetId
|
المراجع إلى جدول بيانات |
chartId
|
الإشارات إلى الرسم البياني لمصدر البيانات |
dataSourceTableAnchorCell
|
للإشارة إلى |
dataSourcePivotTableAnchorCell
|
المرجعية إلى مصدر بيانات
|
dataSourceFormulaCell
|
مراجع لخلية تحتوي على
|