تعرض واحدة أو أكثر من نطاقات القيم التي تطابق فلاتر البيانات المحددة. يجب أن يحدّد المتصل معرّف جدول البيانات وعنصر DataFilters
واحدًا أو أكثر. سيتم عرض النطاقات التي تتطابق مع أيٍّ من فلاتر البيانات في الطلب.
طلب HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
spreadsheetId |
رقم تعريف جدول البيانات المطلوب استرداد البيانات منه. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "dataFilters": [ { object ( |
الحقول | |
---|---|
dataFilters[] |
فلاتر البيانات المستخدمة لمطابقة نطاقات القيم المطلوب استردادها. يتم تضمين النطاقات التي تطابق أيًا من فلاتر البيانات المحددة في الرد. |
majorDimension |
تمثّل هذه السمة السمة الرئيسية التي يجب أن تستخدمها النتائج. على سبيل المثال، إذا كانت بيانات جدول البيانات هي: |
valueRenderOption |
كيف يجب تمثيل القيم في الإخراج. خيار العرض التلقائي هو |
dateTimeRenderOption |
كيف يجب تمثيل التواريخ والأوقات والمدد في الإخراج. يتم تجاهل هذه القيمة إذا كانت قيمة |
نص الاستجابة
الاستجابة عند استرداد أكثر من نطاق واحد من القيم في جدول بيانات تم اختياره من قِبل "DataFilters
"
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"spreadsheetId": string,
"valueRanges": [
{
object ( |
الحقول | |
---|---|
spreadsheetId |
رقم تعريف جدول البيانات الذي تم استرداد البيانات منه. |
valueRanges[] |
القيم المطلوبة مع قائمة فلاتر البيانات المطابقة لها. |
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.
MatchedValueRange
هو نطاق قيمة تمت مطابقته مع ملف بيانات واحد أو أكثر.
تمثيل JSON |
---|
{ "valueRange": { object ( |
الحقول | |
---|---|
valueRange |
القيم التي تطابق |
dataFilters[] |
تمثّل هذه السمة |