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 يتم إدراج صفوف للبيانات الجديدة.