Method: spreadsheets.values.batchUpdateByDataFilter

একটি স্প্রেডশিটের এক বা একাধিক রেঞ্জে মান সেট করে। আরও তথ্যের জন্য, পড়ুন, লিখুন এবং মেটাডেটা অনুসন্ধান করুন দেখুন।

কলারকে অবশ্যই স্প্রেডশিট আইডি, একটি valueInputOption এবং এক বা একাধিক DataFilterValueRanges উল্লেখ করতে হবে।

HTTP অনুরোধ

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter

URL টি gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পথের পরামিতি

পরামিতি
spreadsheetId

string

আপডেট করার জন্য স্প্রেডশিটের আইডি।

অনুরোধের মূল অংশ

অনুরোধের মূল অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON উপস্থাপনা 
{
  "valueInputOption": enum (ValueInputOption),
  "data": [
    {
      object (DataFilterValueRange)
    }
  ],
  "includeValuesInResponse": boolean,
  "responseValueRenderOption": enum (ValueRenderOption),
  "responseDateTimeRenderOption": enum (DateTimeRenderOption)
}
ক্ষেত্র
valueInputOption

enum ( ValueInputOption )

ইনপুট ডেটা কীভাবে ব্যাখ্যা করা উচিত।

data[]

object ( DataFilterValueRange )

স্প্রেডশিটে প্রয়োগ করার জন্য নতুন মান। যদি নির্দিষ্ট DataFilter দ্বারা একাধিক পরিসর মিলে যায় তবে নির্দিষ্ট মানগুলি সেই সমস্ত পরিসরের জন্য প্রয়োগ করা হয়।

includeValuesInResponse

boolean

আপডেট প্রতিক্রিয়াতে আপডেট করা কোষগুলির মান অন্তর্ভুক্ত করা উচিত কিনা তা নির্ধারণ করে। ডিফল্টরূপে, প্রতিক্রিয়াগুলিতে আপডেট করা মান অন্তর্ভুক্ত থাকে না। প্রতিটি BatchUpdateValuesResponse.responses এর মধ্যে updatedData ক্ষেত্রে আপডেট করা মান থাকে। যদি লেখার জন্য পরিসরটি আসলে লেখা পরিসরের চেয়ে বড় হয়, তাহলে প্রতিক্রিয়াটিতে অনুরোধ করা পরিসরের সমস্ত মান অন্তর্ভুক্ত থাকে (পরবর্তী খালি সারি এবং কলামগুলি বাদ দিয়ে)।

responseValueRenderOption

enum ( ValueRenderOption )

প্রতিক্রিয়ার মানগুলি কীভাবে রেন্ডার করা উচিত তা নির্ধারণ করে। ডিফল্ট রেন্ডার বিকল্প হল FORMATTED_VALUE ।

responseDateTimeRenderOption

enum ( DateTimeRenderOption )

প্রতিক্রিয়ার তারিখ, সময় এবং সময়কাল কীভাবে রেন্ডার করা উচিত তা নির্ধারণ করে। responseValueRenderOption FORMATTED_VALUE হলে এটি উপেক্ষা করা হয়। ডিফল্ট dateTime রেন্ডার বিকল্পটি হল SERIAL_NUMBER ।

প্রতিক্রিয়া মূল অংশ

একটি স্প্রেডশিটে মানগুলির একটি পরিসর আপডেট করার সময় প্রতিক্রিয়া।

যদি সফল হয়, তাহলে রেসপন্স বডিতে নিম্নলিখিত কাঠামো সহ ডেটা থাকবে:

JSON উপস্থাপনা 
{
  "spreadsheetId": string,
  "totalUpdatedRows": integer,
  "totalUpdatedColumns": integer,
  "totalUpdatedCells": integer,
  "totalUpdatedSheets": integer,
  "responses": [
    {
      object (UpdateValuesByDataFilterResponse)
    }
  ]
}
ক্ষেত্র
spreadsheetId

string

যে স্প্রেডশিটে আপডেটগুলি প্রয়োগ করা হয়েছিল।

totalUpdatedRows

integer

সারির কমপক্ষে একটি ঘর আপডেট করা হয়েছে এমন সারির মোট সংখ্যা।

totalUpdatedColumns

integer

কলামের কমপক্ষে একটি ঘর আপডেট করা হয়েছে এমন কলামের মোট সংখ্যা।

totalUpdatedCells

integer

মোট কোষের সংখ্যা আপডেট করা হয়েছে।

totalUpdatedSheets

integer

শীটের কমপক্ষে একটি ঘর আপডেট করা হয়েছে এমন শীটের মোট সংখ্যা।

responses[]

object ( UpdateValuesByDataFilterResponse )

প্রতিটি পরিসরের জন্য প্রতিক্রিয়া আপডেট করা হয়েছে।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।

ডেটাফিল্টারভ্যালুরেঞ্জ

একটি DataFilter দ্বারা নির্দিষ্ট করা মানগুলির একটি পরিসর।

JSON উপস্থাপনা 
{
  "dataFilter": {
    object (DataFilter)
  },
  "majorDimension": enum (Dimension),
  "values": [
    array
  ]
}
ক্ষেত্র
dataFilter

object ( DataFilter )

স্প্রেডশিটে মানগুলির অবস্থান বর্ণনা করে ডেটা ফিল্টার।

majorDimension

enum ( Dimension )

মূল্যবোধের প্রধান মাত্রা।

values[]

array ( ListValue format)

যে ডেটা লেখা হবে। যদি প্রদত্ত মানগুলি ডেটা ফিল্টার দ্বারা মিলিত যেকোনো রেঞ্জকে অতিক্রম করে তবে অনুরোধটি ব্যর্থ হয়। যদি প্রদত্ত মানগুলি মিলিত রেঞ্জের চেয়ে কম হয় তবে কেবল নির্দিষ্ট মানগুলি লেখা হয়, মিলিত রেঞ্জগুলিতে বিদ্যমান মানগুলি প্রভাবিত হয় না।

আপডেট ভ্যালুসবাইডেটাফিল্টারপ্রতিক্রিয়া

একটি স্প্রেডশিটে ডেটা ফিল্টার দ্বারা মানগুলির একটি পরিসর আপডেট করার সময় প্রতিক্রিয়া।

JSON উপস্থাপনা 
{
  "updatedRange": string,
  "updatedRows": integer,
  "updatedColumns": integer,
  "updatedCells": integer,
  "dataFilter": {
    object (DataFilter)
  },
  "updatedData": {
    object (ValueRange)
  }
}
ক্ষেত্র
updatedRange

string

যে পরিসরটিতে ( A1 স্বরলিপিতে ) আপডেটগুলি প্রয়োগ করা হয়েছিল।

updatedRows

integer

সারির সংখ্যা যেখানে সারির কমপক্ষে একটি ঘর আপডেট করা হয়েছে।

updatedColumns

integer

কলামের কমপক্ষে একটি ঘর আপডেট করা হয়েছে এমন কলামের সংখ্যা।

updatedCells

integer

কোষের সংখ্যা আপডেট করা হয়েছে।

dataFilter

object ( DataFilter )

যে ডেটা ফিল্টারটি আপডেট করা পরিসরটি নির্বাচন করেছে।

updatedData

object ( ValueRange )

সমস্ত আপডেট প্রয়োগ করার পরে ডেটাফিল্টার দ্বারা মিলিত পরিসরের কোষগুলির মান। এটি কেবল তখনই অন্তর্ভুক্ত করা হয় যদি অনুরোধের includeValuesInResponse ক্ষেত্রটি true হয়।