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

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