- طلب HTTP
- مَعلمات المسار
- معامِلات طلب البحث
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- InsertDataOption
- جرِّبه الآن
لإلحاق القيم بجدول بيانات. يُستخدم نطاق الإدخال للبحث عن البيانات الحالية والعثور على "جدول" ضمن ذلك النطاق. سيتم إلحاق القيم بالصف التالي من الجدول، بدءًا من العمود الأول في الجدول. راجِع الدليل ونموذج الرمز للحصول على تفاصيل محدَّدة حول كيفية اكتشاف الجداول وإلحاق البيانات بها.
يجب أن يحدِّد المتصل رقم تعريف جدول البيانات والنطاق وvalueInputOption
. تتحكّم valueInputOption
فقط في كيفية إضافة بيانات الإدخال إلى ورقة البيانات (من الأعمدة أو الصفوف)، ولا تؤثّر في الخلية التي تبدأ كتابة البيانات عليها.
طلب HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
spreadsheetId |
رقم تعريف جدول البيانات المطلوب تعديله. |
range |
تدوين A1 لنطاق للبحث عن جدول بيانات منطقي. يتم إلحاق القيم بعد الصف الأخير من الجدول. |
معلمات طلب البحث
المَعلمات | |
---|---|
valueInputOption |
كيفية تفسير بيانات الإدخال. |
insertDataOption |
كيفية إدراج بيانات الإدخال |
includeValuesInResponse |
تحدد ما إذا كانت استجابة التحديث يجب أن تتضمن قيم الخلايا التي تم إلحاقها. بشكل تلقائي، لا تتضمّن الردود القيم المعدّلة. |
responseValueRenderOption |
تحدد كيف يجب عرض القيم في الرد. خيار العرض التلقائي هو |
responseDateTimeRenderOption |
لتحديد كيفية عرض التواريخ والأوقات والمدد في الاستجابة. يتم تجاهل هذا إذا كانت قيمة |
نص الطلب
يحتوي نص الطلب على مثال ValueRange
.
نص الاستجابة
الاستجابة عند تعديل نطاق من القيم في جدول بيانات
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"spreadsheetId": string,
"tableRange": string,
"updates": {
object ( |
الحقول | |
---|---|
spreadsheetId |
جدول البيانات الذي تم تطبيق التعديلات عليه. |
tableRange |
النطاق (في ترميز A1) للجدول الذي يتم إلحاق القيم به (قبل إلحاق القيم). يكون الجدول فارغًا في حال عدم العثور على جدول. |
updates |
معلومات عن التعديلات التي تم تطبيقها. |
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.
InsertDataOption
تحدد كيفية تغيير البيانات الموجودة عند إدخال بيانات جديدة.
عمليات التعداد | |
---|---|
OVERWRITE |
تستبدل البيانات الجديدة البيانات الحالية في مناطق كتابتها. (ملاحظة: ستؤدي إضافة البيانات إلى نهاية الورقة إلى إدراج صفوف أو أعمدة جديدة بحيث يمكن كتابة البيانات). |
INSERT_ROWS |
يتم إدراج صفوف للبيانات الجديدة. |