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