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