Method: spreadsheets.values.append

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

على المتصل تحديد معرّف جدول البيانات والنطاق وvalueInputOption. لا يتحكّم العنصر valueInputOption إلا في كيفية إضافة بيانات الإدخال إلى ورقة البيانات (حسب العمود أو الصف)، ولا يؤثّر في الخلية التي تبدأ فيها كتابة البيانات.

طلب HTTP

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
spreadsheetId

string

رقم تعريف جدول البيانات المطلوب تعديله
range

string

ترميز A1 لنطاق للبحث عن جدول منطقي للبيانات يتم إلحاق القيم بعد الصف الأخير من الجدول.

مَعلمات طلب البحث

المعلمات
valueInputOption

enum (ValueInputOption)

كيفية تفسير بيانات الإدخال
insertDataOption

enum (InsertDataOption)

كيفية إدراج بيانات الإدخال
includeValuesInResponse

boolean

لتحديد ما إذا كان يجب أن يتضمّن ردّ التعديل قيم الخلايا التي تمت إضافتها. لا تتضمّن الردود تلقائيًا القيم المعدَّلة.
responseValueRenderOption

enum (ValueRenderOption)

يحدّد كيفية عرض القيم في الاستجابة. الخيار التلقائي للعرض هو FORMATTED_VALUE.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

لتحديد كيفية عرض التواريخ والأوقات والمدد في الاستجابة يتم تجاهل هذا الإجراء إذا كان responseValueRenderOption هو FORMATTED_VALUE. الخيار التلقائي لعرض التاريخ والوقت هو SERIAL_NUMBER.

نص الطلب

يحتوي نص الطلب على مثال ValueRange.

نص الاستجابة

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

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "spreadsheetId": string,
  "tableRange": string,
  "updates": {
    object (UpdateValuesResponse)
  }
}
الحقول
spreadsheetId

string

جدول البيانات الذي تم تطبيق التعديلات عليه
tableRange

string

النطاق (بترميز A1) للجدول الذي يتم إلحاق القيم به (قبل إلحاق القيم). فارغ إذا لم يتم العثور على أي جدول.
updates

object (UpdateValuesResponse)

معلومات عن التعديلات التي تم تطبيقها

نطاقات التفويض

يتطلب أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.

InsertDataOption

يحدِّد كيفية تغيير البيانات الحالية عند إدخال بيانات جديدة.

عمليات التعداد
OVERWRITE تستبدل البيانات الجديدة البيانات الحالية في المناطق التي يتم فيها كتابتها. (ملاحظة: ستؤدي إضافة بيانات إلى نهاية الورقة إلى إدراج صفوف أو أعمدة جديدة حتى يمكن كتابة البيانات).
INSERT_ROWS يتم إدراج صفوف للبيانات الجديدة.