ফিল্ড মাস্ক ব্যবহার করুন, ফিল্ড মাস্ক ব্যবহার করুন

ফিল্ড মাস্ক হল API কলারদের জন্য সেই ক্ষেত্রগুলি তালিকাভুক্ত করার একটি উপায় যা একটি অনুরোধ ফেরত দেওয়া বা আপডেট করা উচিত৷ একটি FieldMask ব্যবহার করে API অপ্রয়োজনীয় কাজ এড়াতে এবং কর্মক্ষমতা উন্নত করতে অনুমতি দেয়। Google Sheets API-এ পঠন ও আপডেট উভয় পদ্ধতির জন্যই একটি ফিল্ড মাস্ক ব্যবহার করা হয়।

একটি ফিল্ড মাস্ক সঙ্গে পড়ুন

স্প্রেডশীটগুলি বড় হতে পারে এবং প্রায়শই আপনার পড়ার অনুরোধের মাধ্যমে ফিরে আসা Spreadsheet সংস্থানের প্রতিটি অংশের প্রয়োজন হয় না। fields ইউআরএল প্যারামিটার ব্যবহার করে আপনি শীট এপিআই প্রতিক্রিয়াতে যা ফিরে এসেছে তা সীমিত করতে পারেন। সেরা পারফরম্যান্সের জন্য, উত্তরে আপনার প্রয়োজনীয় ক্ষেত্রগুলিকে স্পষ্টভাবে তালিকাভুক্ত করুন ৷

ক্ষেত্র প্যারামিটারের বিন্যাস একটি FieldMask-এর JSON এনকোডিংয়ের মতোই। সংক্ষেপে বলা হয়েছে, একাধিক ভিন্ন ক্ষেত্র কমা-বিচ্ছিন্ন এবং সাবফিল্ডগুলি ডট-বিচ্ছিন্ন। ক্ষেত্রের নাম ক্যামেলকেস বা পৃথক_বাই_আন্ডারস্কোরে উল্লেখ করা যেতে পারে। সুবিধার জন্য, একই ধরনের একাধিক সাবফিল্ড বন্ধনীর মধ্যে তালিকাভুক্ত করা যেতে পারে।

নিম্নলিখিত spreadsheets.get অনুরোধের উদাহরণটি স্প্রেডশীটের সমস্ত শীটে একটি SheetProperties অবজেক্টের শুধুমাত্র শীট আইডি, শিরোনাম, SheetType এবং GridProperties আনতে sheets.properties(sheetId,title,sheetType,gridProperties) এর একটি ফিল্ড মাস্ক ব্যবহার করে:

GET https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId?fields=sheets.properties(sheetId,title,sheetType,gridProperties)

এই পদ্ধতি কলের প্রতিক্রিয়া হল একটি Spreadsheet অবজেক্ট যাতে ফিল্ড মাস্কে অনুরোধ করা উপাদান রয়েছে। মনে রাখবেন sheetType=OBJECT gridProperties নেই: 

{
  "sheets": [
    {
      "properties": {
        "sheetId": SHEET_ID,
        "title": "TITLE",
        "sheetType": "GRID",
        "gridProperties": {
          "rowCount": 1000,
          "columnCount": 25
        }
      }
    },
    {
      "properties": {
        "sheetId": SHEET_ID,
        "title": "TITLE",
        "sheetType": "OBJECT"
      }
    }
  ]
}

ফিল্ড মাস্ক দিয়ে আপডেট করুন

কখনও কখনও আপনাকে অন্য ক্ষেত্রগুলি অপরিবর্তিত রেখে একটি বস্তুর শুধুমাত্র নির্দিষ্ট ক্ষেত্র আপডেট করতে হবে। একটি spreadsheets.batchUpdate মধ্যে আপডেটের অনুরোধগুলি.batchUpdate অপারেশন ফিল্ড মাস্ক ব্যবহার করে API কে জানাতে যে কোন ক্ষেত্রগুলি পরিবর্তন করা হচ্ছে৷ হালনাগাদ অনুরোধ ফিল্ড মাস্কে নির্দিষ্ট করা নেই এমন কোনো ক্ষেত্রকে উপেক্ষা করে, তাদের বর্তমান মানগুলি রেখে দেয়।

আপনি আপডেট করা বার্তায় এটি নির্দিষ্ট না করে, কিন্তু মাস্কে ক্ষেত্র যোগ করে একটি ক্ষেত্র আনসেট করতে পারেন। এটি ক্ষেত্রটির পূর্বে যে মান ছিল তা পরিষ্কার করে।

আপডেট ফিল্ড মাস্কের সিনট্যাক্স রিড ফিল্ড মাস্কের মতই।

নিম্নলিখিত উদাহরণটি Grid একটি নতুন শীট যোগ করতে, প্রথম সারিটি ফ্রিজ করতে এবং নতুন শীটের ট্যাবটিকে লাল রঙ করতে AddSheetRequest ব্যবহার করে: 

POST https://sheets.googleapis.com/v1/spreadsheets/spreadsheetId:batchUpdate
{
  "spreadsheetId": "SPREADSHEET_ID",
  "replies": [
    {
      "addSheet": {
        "properties": {
          "sheetId": SHEET_ID,
          "title": "TITLE",
          "index": 6,
          "sheetType": "GRID",
          "gridProperties": {
            "rowCount": 1000,
            "columnCount": 26,
            "frozenRowCount": 1
          },
          "tabColor": {
            "red": 0.003921569
          },
          "tabColorStyle": {
            "rgbColor": {
              "red": 0.003921569
            }
          }
        }
      }
    }
  ]
}