Method: spreadsheets.values.batchGet

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

طلب HTTP

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

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

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

المعلمات
spreadsheetId

string

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

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

المعلمات
ranges[]

string

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

enum (Dimension)

تمثّل هذه السمة السمة الرئيسية التي يجب أن تستخدمها النتائج.

على سبيل المثال، إذا كانت بيانات جدول البيانات هي: A1=1,B1=2,A2=3,B2=4، سيؤدي طلب ranges=["A1:B2"],majorDimension=ROWS إلى عرض [[1,2],[3,4]]، بينما يعرض طلب ranges=["A1:B2"],majorDimension=COLUMNS عرض [[1,3],[2,4]].
valueRenderOption

enum (ValueRenderOption)

كيف يجب تمثيل القيم في الإخراج. خيار العرض التلقائي هو ValueRenderOption.FORMATTED_VALUE.
dateTimeRenderOption

enum (DateTimeRenderOption)

كيف يجب تمثيل التواريخ والأوقات والمدد في الإخراج. يتم تجاهل هذه القيمة إذا كانت قيمة valueRenderOption هي FORMATTED_VALUE. خيار عرض التاريخ والوقت التلقائي هو SERIAL_NUMBER.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

الاستجابة عند استرداد أكثر من نطاق من القيم في جدول بيانات.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "spreadsheetId": string,
  "valueRanges": [
    {
      object (ValueRange)
    }
  ]
}
الحقول
spreadsheetId

string

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

object (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

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