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

تكون القيمة "صحيح" إذا كان يجب استبعاد الجداول في النطاقات المخطَّطة. يتم ضبط القيمة على "خطأ" إذا لم يتم ضبطها.
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

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