Method: spreadsheets.get

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

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

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

  • اضبط مَعلمة عنوان URL includeGridData على true. في حال ضبط قناع حقل، يتم تجاهل المَعلمة 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

صحيح إذا كان يجب استبعاد الجداول في النطاقات المُجمَّعة. خطأ إذا لم يتم ضبطها.

نص الطلب

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

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال 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

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