إرسال ملاحظات
Method: spreadsheets.values.batchGet
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لعرض نطاق واحد أو أكثر من القيم من جدول بيانات. يجب أن يحدد المتصل معرّف جدول البيانات ونطاق واحد أو أكثر.
طلب HTTP
GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet
يستخدِم عنوان URL بنية تحويل ترميز gRPC .
مَعلمات المسار
المعلمات
spreadsheetId
string
رقم تعريف جدول البيانات المطلوب استرداد البيانات منه.
معامِلات طلب البحث
المعلمات
ranges[]
string
تدوين A1 أو تدوين R1C1 للنطاق المطلوب استرداد القيم منه.
majorDimension
enum (Dimension
)
تمثّل هذه السمة السمة الرئيسية التي يجب أن تستخدمها النتائج.
على سبيل المثال، إذا كانت بيانات جدول البيانات هي: A1=1,B1=2,A2=3,B2=4
، سيؤدي طلب ranges=["A1:B2"],majorDimension=ROWS
إلى عرض [[1,2],[3,4]]
، بينما يعرض طلب ranges=["A1:B2"],majorDimension=COLUMNS
عرض [[1,3],[2,4]]
.
valueRenderOption
enum (ValueRenderOption
)
كيف يجب تمثيل القيم في الإخراج. خيار العرض التلقائي هو ValueRenderOption.FORMATTED_VALUE
.
dateTimeRenderOption
enum (DateTimeRenderOption
)
كيف يجب تمثيل التواريخ والأوقات والمدد في الإخراج. يتم تجاهل هذه القيمة إذا كانت قيمة valueRenderOption
هي FORMATTED_VALUE
. خيار عرض التاريخ والوقت التلقائي هو SERIAL_NUMBER
.
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
الاستجابة عند استرداد أكثر من نطاق من القيم في جدول بيانات.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON
{
"spreadsheetId" : string ,
"valueRanges" : [
{
object (ValueRange
)
}
]
}
الحقول
spreadsheetId
string
رقم تعريف جدول البيانات الذي تم استرداد البيانات منه.
valueRanges[]
object (ValueRange
)
القيم المطلوبة يكون ترتيب نطاقات القيم هو نفسه ترتيب النطاقات المطلوبة.
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات 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
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض .
إرسال ملاحظات
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0 . للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers . إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-09-05 (حسب التوقيت العالمي المتفَّق عليه)
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"لا يحتوي على المعلومات التي أحتاج إليها."
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"الخطوات معقدة للغاية / كثيرة جدًا."
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"المحتوى قديم."
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"ثمة مشكلة في الترجمة."
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"مشكلة في العيّنات / التعليمات البرمجية"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"غير ذلك"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"يسهُل فهم المحتوى."
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"ساعَدني المحتوى في حلّ مشكلتي."
},{
"type": "thumb-up",
"id": "otherUp",
"label":"غير ذلك"
}]
هل تريد مشاركة ملاحظاتك معنا؟
{"lastModified": "\u062a\u0627\u0631\u064a\u062e \u0627\u0644\u062a\u0639\u062f\u064a\u0644 \u0627\u0644\u0623\u062e\u064a\u0631: 2024-09-05 (\u062d\u0633\u0628 \u0627\u0644\u062a\u0648\u0642\u064a\u062a \u0627\u0644\u0639\u0627\u0644\u0645\u064a \u0627\u0644\u0645\u062a\u0641\u0651\u064e\u0642 \u0639\u0644\u064a\u0647)"}
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-09-05 (حسب التوقيت العالمي المتفَّق عليه)"]]