لعرض نطاق واحد أو أكثر من القيم من جدول بيانات. يجب أن يحدد المتصل رقم تعريف جدول البيانات ونطاقًا واحدًا أو أكثر.
طلب HTTP
GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
spreadsheetId |
رقم تعريف جدول البيانات لاسترداد البيانات منه. |
معلمات طلب البحث
المَعلمات | |
---|---|
ranges[] |
تدوين A1 أو تدوين R1C1 للنطاق المطلوب استرداد القيم منه. |
majorDimension |
السمة الرئيسية التي يجب أن تستخدمها النتائج. على سبيل المثال، إذا كانت بيانات جدول البيانات هي: |
valueRenderOption |
كيفية تمثيل القيم في الناتج خيار العرض التلقائي هو |
dateTimeRenderOption |
كيفية تمثيل التواريخ والأوقات والمدد في الإخراج يتم تجاهل هذا إذا كانت قيمة |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
الاستجابة عند استرداد أكثر من نطاق واحد من القيم في جدول بيانات.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"spreadsheetId": string,
"valueRanges": [
{
object ( |
الحقول | |
---|---|
spreadsheetId |
رقم تعريف جدول البيانات الذي تم استرداد البيانات منه. |
valueRanges[] |
القيم المطلوبة. يكون ترتيب نطاقات القيم هو نفسه ترتيب النطاقات المطلوبة. |
نطاقات التفويض
يتطلب استخدام أحد نطاقات 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
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.