Method: spreadsheets.values.append

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

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المَعلمات
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

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

إدراج بيانات

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

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