تعرض نطاق واحد أو أكثر من القيم التي تطابق فلاتر البيانات المحدّدة. يجب أن يحدّد المتصل معرّف جدول البيانات ومعرّف 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[] |
|