Method: spreadsheets.values.get

تعرض نطاقًا من القيم من جدول بيانات. يجب أن يحدّد المتصل رقم تعريف جدول البيانات ونطاقه.

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المَعلمات
spreadsheetId

string

رقم تعريف جدول البيانات لاسترداد البيانات منه.

range

string

تدوين A1 أو ترميز R1C1 للنطاق الذي تريد استرداد القيم منه.

معلمات طلب البحث

المَعلمات
majorDimension

enum (Dimension)

البُعد الرئيسي الذي يجب أن تستخدمه النتائج.

على سبيل المثال، إذا كانت بيانات جدول البيانات في ورقة البيانات هي: 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. إنّ خيار العرض التلقائي للتاريخ والوقت هو 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

لمزيد من المعلومات، اطّلِع على دليل التفويض.