Method: spreadsheets.get

تعرض هذه الدالة جدول البيانات الذي يحمل رقم التعريف المحدّد. على المتصل تحديد رقم تعريف جدول البيانات.

لا يتم عرض البيانات داخل الجداول تلقائيًا. يمكنك تضمين بيانات الجدول بإحدى الطريقتَين التاليتَين:

  • حدِّد قناع حقل يسرد الحقول المطلوبة باستخدام مَعلمة عنوان URL fields في HTTP

  • اضبط مَعلمة عنوان URL includeGridData على "صحيح". في حال ضبط قناع حقل، يتم تجاهل المَعلمة includeGridData

بالنسبة إلى جداول البيانات الكبيرة، ننصحك باسترداد حقول جدول البيانات المحدّدة التي تريدها فقط.

لاسترداد مجموعات فرعية فقط من بيانات جدول البيانات، استخدِم مَعلمة عنوان URL ranges. يتم تحديد النطاقات باستخدام ترميز A1. يمكنك تحديد خلية واحدة (مثل A1) أو خلايا متعددة (مثل A1:D5). يمكنك أيضًا الحصول على خلايا من أوراق أخرى ضمن جدول البيانات نفسه (مثل Sheet2!A1:C4) أو استرداد نطاقات متعددة في آنٍ واحد (مثل ?ranges=A1:D5&ranges=Sheet2!A1:C4). يؤدي حصر النطاق إلى عرض الأجزاء من جدول البيانات التي تتقاطع مع النطاقات المطلوبة فقط.

طلب HTTP

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

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

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

المعلمات
spreadsheetId

string

جدول البيانات المطلوب

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

المعلمات
ranges[]

string

النطاقات المطلوب استردادها من جدول البيانات
includeGridData

boolean

تُعرض القيمة "صحيح" إذا كان من المفترض عرض بيانات الشبكة. يتم تجاهل هذه المَعلمة إذا تم ضبط قناع حقل في الطلب.
excludeTablesInBandedRanges

boolean

تكون القيمة true إذا كان يجب استبعاد الجداول في النطاقات المخطَّطة. يتم ضبط القيمة على "خطأ" إذا لم يتم ضبطها.
commentsViewMode

enum (CommentsViewMode)

وضع عرض التعليقات الذي سيتم تطبيقه على جدول البيانات. يسمح ذلك بعرض جدول البيانات مع إغفال التعليقات أو تضمينها. إذا لم يتم تحديد أيّ منهما، يتم استخدام COMMENTS_VIEW_MODE_OMITTED.

نص الطلب

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال Spreadsheet.

نطاقات الأذونات

يجب توفير أحد نطاقات 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

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