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

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

نص الطلب

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

نص الاستجابة

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

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