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 Transcode.

معلّمات المسار

المَعلمات
spreadsheetId

string

جدول البيانات المطلوب إرساله.

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

المَعلمات
ranges[]

string

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

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

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