Method: spreadsheets.values.get

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

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز gRPC.

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

المَعلمات
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. خيار العرض التلقائي للتاريخ والوقت هو 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

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