Method: spreadsheets.values.append

مقادیر را به صفحه گسترده اضافه می کند. محدوده ورودی برای جستجوی داده های موجود و یافتن یک "جدول" در آن محدوده استفاده می شود. مقادیر به سطر بعدی جدول اضافه می شود که از ستون اول جدول شروع می شود. برای جزئیات خاص نحوه شناسایی جداول و ضمیمه داده ها به راهنما و کد نمونه مراجعه کنید.

تماس گیرنده باید شناسه صفحه گسترده، محدوده و یک valueInputOption را مشخص کند. valueInputOption فقط نحوه اضافه شدن داده‌های ورودی به صفحه را کنترل می‌کند (ستون‌دار یا ردیف)، این تأثیری ندارد که داده‌ها در چه سلولی شروع به نوشتن می‌کنند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
spreadsheetId

string

شناسه صفحه‌گسترده برای به‌روزرسانی.

range

string

نماد A1 یک محدوده برای جستجوی یک جدول منطقی از داده ها. مقادیر بعد از آخرین ردیف جدول اضافه می شوند.

پارامترهای پرس و جو

مولفه های
valueInputOption

enum ( ValueInputOption )

چگونه داده های ورودی باید تفسیر شوند.

insertDataOption

enum ( InsertDataOption )

چگونه داده های ورودی باید درج شوند.

includeValuesInResponse

boolean

تعیین می کند که آیا پاسخ به روز رسانی باید شامل مقادیر سلول هایی باشد که اضافه شده اند یا خیر. به طور پیش فرض، پاسخ ها شامل مقادیر به روز شده نمی شوند.

responseValueRenderOption

enum ( ValueRenderOption )

تعیین می کند که مقادیر در پاسخ چگونه باید ارائه شوند. گزینه رندر پیش فرض FORMATTED_VALUE است.

responseDateTimeRenderOption

enum ( DateTimeRenderOption )

تعیین می کند که چگونه تاریخ ها، زمان ها و مدت زمان در پاسخ باید ارائه شوند. اگر responseValueRenderOption FORMATTED_VALUE باشد، نادیده گرفته می شود. گزینه پیش‌فرض render dateTime 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

نحوه تغییر داده های موجود هنگام ورود داده های جدید را تعیین می کند.

Enums
OVERWRITE داده های جدید، داده های موجود را در مناطقی که نوشته شده اند، بازنویسی می کند. (توجه: با افزودن داده به انتهای برگه همچنان سطرها یا ستون‌های جدیدی وارد می‌شود تا بتوان داده‌ها را نوشت.)
INSERT_ROWS ردیف هایی برای داده های جدید درج می شوند.