Method: spreadsheets.values.get

محدوده ای از مقادیر را از یک صفحه گسترده برمی گرداند. تماس گیرنده باید شناسه صفحه گسترده و یک محدوده را مشخص کند.

درخواست HTTP

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

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

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

مولفه های
spreadsheetId

string

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

range

string

نماد A1 یا نماد R1C1 محدوده برای بازیابی مقادیر.

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

مولفه های
majorDimension

enum ( Dimension )

بعد عمده ای که نتایج باید استفاده شود.

به عنوان مثال، اگر داده های صفحه گسترده در Sheet1 عبارتند از: A1=1,B1=2,A2=3,B2=4 , سپس درخواست range=Sheet1!A1:B2?majorDimension=ROWS [[1,2],[3,4]] ، در حالی که درخواست range=Sheet1!A1:B2?majorDimension=COLUMNS [[1,3],[2,4]] را برمی گرداند.

valueRenderOption

enum ( ValueRenderOption )

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

dateTimeRenderOption

enum ( DateTimeRenderOption )

چگونه تاریخ، زمان و مدت زمان باید در خروجی نمایش داده شود. اگر valueRenderOption FORMATTED_VALUE باشد، این نادیده گرفته می‌شود. گزینه پیش‌فرض render dateTime SERIAL_NUMBER است.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از ValueRange است.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets
  • https://www.googleapis.com/auth/spreadsheets.readonly

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.