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)

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

UpdateValuesByDataFilterResponse

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

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 হলেই এটি অন্তর্ভুক্ত করা হয়।