মেটাডেটা পড়ুন, লিখুন এবং অনুসন্ধান করুন

মেটাডেটা বৈশিষ্ট্যটি আপনাকে একটি স্প্রেডশিটে বিভিন্ন সত্তা এবং অবস্থানের সাথে মেটাডেটা সংযুক্ত করতে দেয়। এরপর আপনি এই মেটাডেটাটি অনুসন্ধান করতে পারেন এবং এটি ব্যবহার করে এটি যে বস্তুগুলির সাথে সম্পর্কিত তা খুঁজে পেতে পারেন।

আপনি সারি, কলাম, শিট, অথবা স্প্রেডশিটের সাথে মেটাডেটা সংযুক্ত করতে পারেন।

মেটাডেটা সম্পর্কে

শীটস এপিআই-এর সাথে কাজ করার সময় আপনার বিবেচনা করা উচিত এমন মেটাডেটার কিছু গুরুত্বপূর্ণ দিক নিচে বর্ণনা করা হল:

1. ট্যাগ হিসেবে মেটাডেটা : ডেভেলপার মেটাডেটার একটি ব্যবহার হল এমন একটি ট্যাগ যা শুধুমাত্র একটি কী এবং একটি অবস্থান ব্যবহার করে স্প্রেডশিটে একটি অবস্থানের নাম দেয়। উদাহরণস্বরূপ, আপনি একটি নির্দিষ্ট সারির সাথে headerRow অথবা একটি শীটের মধ্যে একটি নির্দিষ্ট কলামের সাথে totals সংযুক্ত করতে পারেন। ট্যাগগুলি একটি স্প্রেডশিটের অংশগুলিকে তৃতীয় পক্ষের টুল বা ডাটাবেসের ফিল্ডের সাথে অর্থপূর্ণভাবে আবদ্ধ করতে ব্যবহার করা যেতে পারে, তাই স্প্রেডশিটে পরিবর্তনগুলি আপনার অ্যাপকে নষ্ট করবে না।

2. মেটাডেটা বৈশিষ্ট্য হিসেবে : একটি কী, অবস্থান এবং একটি মান নির্দিষ্ট করে তৈরি মেটাডেটা একটি শীটে সেই অবস্থানের সাথে যুক্ত একটি কী-মান জোড়া হিসেবে কাজ করে। উদাহরণস্বরূপ, আপনি সংযুক্ত করতে পারেন:

   • formResponseId = resp123 একটি সারি সহ
   • lastUpdated = 1477369882 একটি কলাম সহ

   এটি আপনাকে একটি স্প্রেডশিটে নির্দিষ্ট এলাকা বা ডেটার সাথে সম্পর্কিত কাস্টম নামযুক্ত বৈশিষ্ট্য সংরক্ষণ এবং অ্যাক্সেস করতে দেয়।

3. প্রকল্প বনাম ডকুমেন্ট দৃশ্যমান মেটাডেটা : একটি ডেভেলপার প্রকল্প যাতে অন্যের মেটাডেটাতে হস্তক্ষেপ না করে, তার জন্য দুটি মেটাডেটা visibility সেটিংস রয়েছে: project এবং document । শীটস এপিআই ব্যবহার করে, project মেটাডেটা কেবল সেই গুগল ক্লাউড প্রকল্প থেকেই দৃশ্যমান এবং অ্যাক্সেসযোগ্য যা এটি তৈরি করেছে। ডকুমেন্টে অ্যাক্সেস সহ যেকোনো গুগল ক্লাউড প্রকল্প থেকে document মেটাডেটা অ্যাক্সেসযোগ্য।

   যেসব কোয়েরিতে visibility স্পষ্টভাবে উল্লেখ করা হয়নি, সেগুলি অনুরোধকারী Google ক্লাউড প্রোজেক্টের জন্য document মেটাডেটা এবং ম্যাচিং project মেটাডেটার মিল খুঁজে বের করে।

   সুরক্ষা ব্যবস্থা হিসেবে বা গোপন তথ্য সংরক্ষণের জন্য প্রকল্প-দৃশ্যমান ডেভেলপার মেটাডেটা ব্যবহার করবেন না। ডকুমেন্ট দেখার অ্যাক্সেস আছে এমন ব্যবহারকারীদের কাছে মেটাডেটা প্রকাশিত হতে পারে।

4. অনন্যতা : মেটাডেটা কীগুলি অনন্য হতে হবে না, তবে metadataId অবশ্যই স্বতন্ত্র হতে হবে। আপনি যদি মেটাডেটা তৈরি করেন এবং এর আইডি ফিল্ডটি অনির্দিষ্ট রাখেন, তাহলে API একটি নির্দিষ্ট করে। এই আইডিটি মেটাডেটা সনাক্ত করতে ব্যবহার করা যেতে পারে, যখন কী এবং অন্যান্য বৈশিষ্ট্যগুলি মেটাডেটার সেট সনাক্ত করতে ব্যবহার করা যেতে পারে।

   যদিও মেটাডেটা তৈরি করার সময় আপনি আপনার নিজস্ব `metadataId` নির্দিষ্ট করতে পারেন, আমরা আপনাকে Sheets API-কে আপনার জন্য একটি বরাদ্দ করার অনুমতি দেওয়ার পরামর্শ দিচ্ছি।

5. API অনুরোধের মাধ্যমে মেটাডেটা ফেরত দিন : একটি DataFilter অবজেক্ট হল একটি API কলের অংশ যা একটি API অনুরোধ থেকে নির্বাচিত বা ফেরত পাঠানো ডেটা বর্ণনা করে।

   একটি একক DataFilter অবজেক্ট ডেটা সনাক্ত করার জন্য শুধুমাত্র এক ধরণের ফিল্টার মানদণ্ড নির্দিষ্ট করতে পারে:

   • developerMetadataLookup : নির্দিষ্ট ডেভেলপার মেটাডেটার সাথে সম্পর্কিত মানদণ্ডের সাথে মেলে এমন ডেটা নির্বাচন করে।

   • a1Range : নির্দিষ্ট A1 নোটেশন রেঞ্জের সাথে মেলে এমন ডেটা নির্বাচন করে। উদাহরণস্বরূপ, Sheet1!A1:B10 ।

   • gridRange : শূন্য-ভিত্তিক সূচক ব্যবহার করে নির্দিষ্ট গ্রিড পরিসরের সাথে মেলে এমন ডেটা নির্বাচন করে। উদাহরণস্বরূপ, Sheet1!A3:B4 == sheetId: 123456, startRowIndex: 2, endRowIndex: 4, startColumnIndex: 0, endColumnIndex: 2 ।

   একাধিক অবস্থান বা মানদণ্ড জুড়ে ফিল্টার করার জন্য, আপনি একটি একক API অনুরোধে একাধিক DataFilter অবজেক্ট ব্যবহার করতে পারেন। spreadsheets.values.batchGetByDataFilter পদ্ধতির মতো একটি ব্যাচ অনুরোধে DataFilter অবজেক্টের একটি অ্যারে বা তালিকা প্রদান করুন। অনুরোধের যেকোনো ডেটা ফিল্টারের সাথে মেলে এমন যেকোনো পরিসর ফেরত দেওয়া হবে বা পরিবর্তন করা হবে।

   আরও তথ্যের জন্য, মেটাডেটার সাথে সম্পর্কিত পঠন এবং লেখার মানগুলি দেখুন।

ব্যবহারের ক্ষেত্রে

মেটাডেটা পরিচালনার জন্য কিছু উদাহরণের উদাহরণ নিচে দেওয়া হল:

• একটি স্প্রেডশিটে বিভিন্ন সত্তা এবং অবস্থানের সাথে ইচ্ছামত ডেটা সংযুক্ত করুন : উদাহরণস্বরূপ, কলাম D এর সাথে totals যুক্ত করুন, অথবা responseId = 1234 সারির ৭ এর সাথে যুক্ত করুন।

• একটি নির্দিষ্ট মেটাডেটা কী বা অ্যাট্রিবিউটের সাথে সম্পর্কিত সমস্ত অবস্থান এবং ডেটা খুঁজুন : উদাহরণস্বরূপ, কলাম D এর সাথে সম্পর্কিত কী totals বা responseId দেওয়া হলে, responseId মেটাডেটা এবং তাদের সাথে সম্পর্কিত মেটাডেটা মান সহ সমস্ত সারি ফেরত দিন।

• একটি নির্দিষ্ট সত্তা বা অবস্থানের সাথে সম্পর্কিত সমস্ত ডেটা খুঁজুন : উদাহরণস্বরূপ, প্রদত্ত কলাম D, সেই অবস্থানের সাথে সম্পর্কিত সমস্ত মেটাডেটা ফেরত দিন।

• সংশ্লিষ্ট মেটাডেটা নির্দিষ্ট করে একটি অবস্থানে মান পুনরুদ্ধার করুন : উদাহরণস্বরূপ, totals সংশ্লিষ্ট কলাম বা সারিতে থাকা মানগুলির একটি প্রতিনিধিত্ব প্রদান করে অথবা একটি summary প্রদান করে সংশ্লিষ্ট শীট সম্পদের একটি প্রতিনিধিত্ব প্রদান করে।

• সংশ্লিষ্ট মেটাডেটা নির্দিষ্ট করে একটি অবস্থানের মান আপডেট করুন : উদাহরণস্বরূপ, A1 নোটেশনের মাধ্যমে পরপর মান আপডেট করার পরিবর্তে, একটি মেটাডেটা আইডি নির্দেশ করে মান আপডেট করুন।

মেটাডেটা পড়ুন এবং লিখুন

spreadsheets.developerMetadata রিসোর্সটি স্প্রেডশিটে থাকা কোনও অবস্থান বা বস্তুর সাথে সম্পর্কিত মেটাডেটা অ্যাক্সেস প্রদান করে। ডেভেলপার মেটাডেটা স্প্রেডশিটের বিভিন্ন অংশের সাথে ইচ্ছামত ডেটা সংযুক্ত করতে ব্যবহার করা যেতে পারে। স্প্রেডশিট সম্পাদনা করার সময় মেটাডেটা সেই অবস্থানগুলিতে সংযুক্ত থাকে।

মেটাডেটা তৈরি করুন

মেটাডেটা তৈরি করতে, spreadsheets রিসোর্সে batchUpdate পদ্ধতি ব্যবহার করুন এবং spreadsheets.developerMetadata রিসোর্স থেকে metadataKey , location এবং visibility মান সহ একটি CreateDeveloperMetadataRequest সরবরাহ করুন। আপনি ঐচ্ছিকভাবে একটি metadataValue অথবা একটি স্পষ্ট metadataId নির্দিষ্ট করতে পারেন।

যদি আপনি এমন একটি আইডি নির্দিষ্ট করেন যা ইতিমধ্যেই ব্যবহৃত হচ্ছে, তাহলে অনুরোধটি ব্যর্থ হবে। যদি আপনি একটি আইডি সরবরাহ না করেন, তাহলে API একটি নির্দিষ্ট করে।

এই উদাহরণে, আমরা অনুরোধে একটি কী, মান এবং একটি সারি প্রদান করি। প্রতিক্রিয়াটি এই ডেভেলপার মেটাডেটা মানগুলি, এবং নির্ধারিত মেটাডেটা আইডি প্রদান করে।

অনুরোধ

{
  "requests": [
    {
      "createDeveloperMetadata": {
        "developerMetadata": {
          "location": {
            "dimensionRange": {
              "sheetId": SHEET_ID,
              "dimension": "ROWS",
              "startIndex": 6,
              "endIndex": 7
            }
          },
          "visibility": "DOCUMENT",
          "metadataKey": "Sales",
          "metadataValue": "2022"
        }
      }
    }
  ]
}

প্রতিক্রিয়া

{
  "spreadsheetId": SPREADSHEET_ID,
  "replies": [
    {
      "createDeveloperMetadata": {
        "developerMetadata": {
          "metadataId": METADATA_ID,
          "metadataKey": "Sales",
          "metadataValue": "2022",
          "location": {
            "locationType": "ROW",
            "dimensionRange": {
              "sheetId": SHEET_ID,
              "dimension": "ROWS",
              "startIndex": 6,
              "endIndex": 7
            }
          },
          "visibility": "DOCUMENT"
        }
      }
    }
  ]
}

একটি একক মেটাডেটা আইটেম পড়ুন

একটি একক, স্বতন্ত্র ডেভেলপার মেটাডেটা পুনরুদ্ধার করতে, spreadsheets.developerMetadata.get পদ্ধতি ব্যবহার করুন, যেখানে মেটাডেটা ধারণকারী spreadsheetId এবং ডেভেলপার মেটাডেটার অনন্য metadataId উল্লেখ করুন।

অনুরোধ

এই উদাহরণে, আমরা অনুরোধে স্প্রেডশিট আইডি এবং মেটাডেটা আইডি প্রদান করি। প্রতিক্রিয়াটি মেটাডেটা আইডির জন্য ডেভেলপার মেটাডেটা মানগুলি ফেরত দেয়।

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/developerMetadata/METADATA_ID

প্রতিক্রিয়া

{
  "metadataId": METADATA_ID,
  "metadataKey": "Sales",
  "metadataValue": "2022",
  "location": {
    "locationType": "ROW",
    "dimensionRange": {
      "sheetId": SHEET_ID,
      "dimension": "ROWS",
      "startIndex": 6,
      "endIndex": 7
    }
  },
  "visibility": "DOCUMENT"
}

একাধিক মেটাডেটা আইটেম পড়ুন

ডেভেলপার মেটাডেটার একাধিক আইটেম পুনরুদ্ধার করতে, spreadsheets.developerMetadata.search পদ্ধতি ব্যবহার করুন। আপনাকে এমন একটি DataFilter নির্দিষ্ট করতে হবে যা কী, মান, অবস্থান বা দৃশ্যমানতার মতো যেকোনো বৈশিষ্ট্যের সংমিশ্রণে বিদ্যমান মেটাডেটার সাথে মেলে।

এই উদাহরণে, আমরা অনুরোধে একাধিক মেটাডেটা আইডি প্রদান করি। প্রতিক্রিয়া প্রতিটি মেটাডেটা আইডির জন্য ডেভেলপার মেটাডেটা মান ফেরত দেয়।

অনুরোধ

{
  "dataFilters": [
    {
      "developerMetadataLookup": {
        "metadataId": METADATA_ID
      }
    },
    {
      "developerMetadataLookup": {
        "metadataId": METADATA_ID
      }
    }
  ]
}

প্রতিক্রিয়া

{
  "matchedDeveloperMetadata": [
    {
      "developerMetadata": {
        "metadataId": METADATA_ID,
        "metadataKey": "Revenue",
        "metadataValue": "2022",
        "location": {
          "locationType": "SHEET",
          "sheetId": SHEET_ID
        },
        "visibility": "DOCUMENT"
      },
      "dataFilters": [
        {
          "developerMetadataLookup": {
            "metadataId": METADATA_ID
          }
        }
      ]
    },
    {
      "developerMetadata": {
        "metadataId": METADATA_ID,
        "metadataKey": "Sales",
        "metadataValue": "2022",
        "location": {
          "locationType": "SHEET",
          "sheetId": SHEET_ID
        },
        "visibility": "DOCUMENT"
      },
      "dataFilters": [
        {
          "developerMetadataLookup": {
            "metadataId": METADATA_ID
          }
        }
      ]
    }
  ]
}

মেটাডেটা আপডেট করুন

ডেভেলপার মেটাডেটা আপডেট করতে, spreadsheets.batchUpdate পদ্ধতি ব্যবহার করুন এবং একটি UpdateDeveloperMetadataRequest সরবরাহ করুন। আপনাকে একটি DataFilter নির্দিষ্ট করতে হবে যা আপডেট করা মেটাডেটা লক্ষ্য করে, একটি spreadsheets.developerMetadata রিসোর্স নতুন মান সহ, এবং আপডেট করা ক্ষেত্রগুলি বর্ণনা করে একটি ফিল্ড মাস্ক ।

এই উদাহরণে, আমরা অনুরোধে মেটাডেটা আইডি, শিট আইডি এবং একটি নতুন মেটাডেটা কী প্রদান করি। প্রতিক্রিয়াটি এই ডেভেলপার মেটাডেটা মানগুলি, এবং আপডেট করা মেটাডেটা কী প্রদান করে।

অনুরোধ

{
  "requests": [
    {
      "updateDeveloperMetadata": {
        "dataFilters": [
          {
            "developerMetadataLookup": {
              "metadataId": METADATA_ID
            }
          }
        ],
        "developerMetadata": {
          "location": {
            "sheetId": SHEET_ID
          },
          "metadataKey": "SalesUpdated"
        },
        "fields": "location,metadataKey"
      }
    }
  ]
}

প্রতিক্রিয়া

{
  "spreadsheetId": SPREADSHEET_ID,
  "replies": [
    {
      "updateDeveloperMetadata": {
        "developerMetadata": [
          {
            "metadataId": METADATA_ID,
            "metadataKey": "SalesUpdated",
            "metadataValue": "2022",
            "location": {
              "locationType": "SHEET",
              "sheetId": SHEET_ID
            },
            "visibility": "DOCUMENT"
          }
        ]
      }
    }
  ]
}

মেটাডেটা মুছুন

ডেভেলপার মেটাডেটা মুছে ফেলার জন্য, batchUpdate পদ্ধতি ব্যবহার করুন এবং একটি DeleteDeveloperMetadataRequest সরবরাহ করুন। আপনি যে মেটাডেটা মুছে ফেলতে চান তা নির্বাচন করতে আপনাকে একটি DataFilter নির্দিষ্ট করতে হবে।

এই উদাহরণে, আমরা অনুরোধে মেটাডেটা আইডি প্রদান করি। প্রতিক্রিয়াটি মেটাডেটা আইডির জন্য ডেভেলপার মেটাডেটা মানগুলি ফেরত দেয়।

ডেভেলপার মেটাডেটা সরানো হয়েছে কিনা তা নিশ্চিত করতে, মুছে ফেলা মেটাডেটা আইডি নির্দিষ্ট করে spreadsheets.developerMetadata.get পদ্ধতিটি ব্যবহার করুন। আপনি একটি 404: Not Found HTTP স্ট্যাটাস কোড প্রতিক্রিয়া পাবেন, যেখানে একটি বার্তা থাকবে " METADATA_ID আইডি সহ কোনও ডেভেলপার মেটাডেটা নেই।"

অনুরোধ

{
  "requests": [
    {
      "deleteDeveloperMetadata": {
        "dataFilter": {
          "developerMetadataLookup": {
            "metadataId": METADATA_ID
          }
        }
      }
    }
  ]
}

প্রতিক্রিয়া

{
  "spreadsheetId": SPREADSHEET_ID,
  "replies": [
    {
      "deleteDeveloperMetadata": {
        "deletedDeveloperMetadata": [
          {
            "metadataId": METADATA_ID,
            "metadataKey": "SalesUpdated",
            "metadataValue": "2022",
            "location": {
              "locationType": "SHEET",
              "sheetId": SHEET_ID
            },
            "visibility": "DOCUMENT"
          }
        ]
      }
    }
  ]
}

মেটাডেটার সাথে সম্পর্কিত মানগুলি পড়ুন এবং লিখুন

আপনি সংশ্লিষ্ট ডেভেলপার মেটাডেটা এবং আপনি যে মানগুলি আপডেট করতে চান তা নির্দিষ্ট করে সারি এবং কলামে সেল মানগুলি পুনরুদ্ধার এবং আপডেট করতে পারেন। এটি করার জন্য, একটি মিলিত DataFilter দিয়ে নিম্নলিখিত পদ্ধতিগুলির মধ্যে একটি ব্যবহার করুন।

মেটাডেটা অনুসারে কোষের মান পান

মেটাডেটা অনুসারে সেল মান পেতে, spreadsheets.values.batchGetByDataFilter পদ্ধতি ব্যবহার করুন। আপনাকে স্প্রেডশিট আইডি এবং মেটাডেটার সাথে মেলে এমন এক বা একাধিক ডেটা ফিল্টার নির্দিষ্ট করতে হবে।

এই উদাহরণে, আমরা অনুরোধে মেটাডেটা আইডি প্রদান করি। প্রতিক্রিয়াটি মেটাডেটা আইডির জন্য সারি সেল মান (মডেল নম্বর, মাসিক বিক্রয়) প্রদান করে।

অনুরোধ

{
  "dataFilters": [
    {
      "developerMetadataLookup": {
        "metadataId": METADATA_ID
      }
    }
  ],
  "majorDimension": "ROWS"
}

প্রতিক্রিয়া

{
  "spreadsheetId": SPREADSHEET_ID,
  "valueRanges": [
    {
      "valueRange": {
        "range": "Sheet7!A7:Z7",
        "majorDimension": "ROWS",
        "values": [
          [
            "W-24",
            "74"
          ]
        ]
      },
      "dataFilters": [
        {
          "developerMetadataLookup": {
            "metadataId": METADATA_ID
          }
        }
      ]
    }
  ]
}

মেটাডেটা অনুসারে স্প্রেডশিট পান

স্প্রেডশিট পুনরুদ্ধার করার সময়, আপনি spreadsheets.getByDataFilter পদ্ধতি ব্যবহার করে ডেটার একটি উপসেট ফেরত দিতে পারেন। আপনাকে স্প্রেডশিট আইডি এবং মেটাডেটার সাথে মেলে এমন এক বা একাধিক ডেটা ফিল্টার নির্দিষ্ট করতে হবে।

এই অনুরোধটি একটি নিয়মিত "স্প্রেডশিট GET" অনুরোধ হিসেবে কাজ করে, তবে নির্দিষ্ট ডেটা ফিল্টার দ্বারা মিলিত মেটাডেটার তালিকা নির্ধারণ করে যে কোন শিট, গ্রিড ডেটা এবং মেটাডেটা সহ অন্যান্য অবজেক্ট রিসোর্সগুলি ফেরত পাঠানো হবে। যদি includeGridData true সেট করা থাকে, তাহলে নির্দিষ্ট গ্রিড রেঞ্জগুলিকে ছেদকারী গ্রিড ডেটাও শিটের জন্য ফেরত পাঠানো হয়। অনুরোধে একটি ফিল্ড মাস্ক সেট করা থাকলে includeGridData ক্ষেত্রটি উপেক্ষা করা হয়।

এই উদাহরণে, আমরা মেটাডেটা আইডি প্রদান করি এবং অনুরোধে includeGridData কে false হিসেবে সেট করি। প্রতিক্রিয়াটি স্প্রেডশিট এবং শিট উভয় বৈশিষ্ট্যই ফেরত দেয়।

অনুরোধ

{
  "dataFilters": [
    {
      "developerMetadataLookup": {
        "metadataId": METADATA_ID
      }
    }
  ],
  "includeGridData": false
}

প্রতিক্রিয়া

{
  "spreadsheetId": SPREADSHEET_ID,
  "properties": {
    "title": "Sales Sheet",
    "locale": "en_US",
    "autoRecalc": "ON_CHANGE",
    "timeZone": "America/Los_Angeles",
    "defaultFormat": {
      "backgroundColor": {
        "red": 1,
        "green": 1,
        "blue": 1
      },
      "padding": {
        "top": 2,
        "right": 3,
        "bottom": 2,
        "left": 3
      },
      "verticalAlignment": "BOTTOM",
      "wrapStrategy": "OVERFLOW_CELL",
      "textFormat": {
        "foregroundColor": {},
        "fontFamily": "arial,sans,sans-serif",
        "fontSize": 10,
        "bold": false,
        "italic": false,
        "strikethrough": false,
        "underline": false,
        "foregroundColorStyle": {
          "rgbColor": {}
        }
      },
      "backgroundColorStyle": {
        "rgbColor": {
          "red": 1,
          "green": 1,
          "blue": 1
        }
      }
    },
    "spreadsheetTheme": {
      "primaryFontFamily": "Arial",
      "themeColors": [
        {
          "colorType": "TEXT",
          "color": {
            "rgbColor": {}
          }
        },
        {
          "colorType": "BACKGROUND",
          "color": {
            "rgbColor": {
              "red": 1,
              "green": 1,
              "blue": 1
            }
          }
        },
        {
          "colorType": "ACCENT1",
          "color": {
            "rgbColor": {
              "red": 0.25882354,
              "green": 0.52156866,
              "blue": 0.95686275
            }
          }
        },
        {
          "colorType": "ACCENT2",
          "color": {
            "rgbColor": {
              "red": 0.91764706,
              "green": 0.2627451,
              "blue": 0.20784314
            }
          }
        },
        {
          "colorType": "ACCENT3",
          "color": {
            "rgbColor": {
              "red": 0.9843137,
              "green": 0.7372549,
              "blue": 0.015686275
            }
          }
        },
        {
          "colorType": "ACCENT4",
          "color": {
            "rgbColor": {
              "red": 0.20392157,
              "green": 0.65882355,
              "blue": 0.3254902
            }
          }
        },
        {
          "colorType": "ACCENT5",
          "color": {
            "rgbColor": {
              "red": 1,
              "green": 0.42745098,
              "blue": 0.003921569
            }
          }
        },
        {
          "colorType": "ACCENT6",
          "color": {
            "rgbColor": {
              "red": 0.27450982,
              "green": 0.7411765,
              "blue": 0.7764706
            }
          }
        },
        {
          "colorType": "LINK",
          "color": {
            "rgbColor": {
              "red": 0.06666667,
              "green": 0.33333334,
              "blue": 0.8
            }
          }
        }
      ]
    }
  },
  "sheets": [
    {
      "properties": {
        "sheetId": SHEET_ID,
        "title": "Sheet7",
        "index": 7,
        "sheetType": "GRID",
        "gridProperties": {
          "rowCount": 1000,
          "columnCount": 26
        }
      }
    }
  ],
  "spreadsheetUrl": SPREADSHEET_URL
}

মেটাডেটা অনুসারে মান আপডেট করুন

নির্দিষ্ট মেটাডেটার সাথে মিলে যাওয়া সেল মান আপডেট করতে, spreadsheets.values.batchUpdateByDataFilter পদ্ধতি ব্যবহার করুন। আপনাকে স্প্রেডশিট আইডি, valueInputOption এবং মেটাডেটার সাথে মেলে এমন এক বা একাধিক DataFilterValueRange মান নির্দিষ্ট করতে হবে।

এই উদাহরণে, আমরা অনুরোধে মেটাডেটা আইডি এবং আপডেট করা সারি মান প্রদান করি। প্রতিক্রিয়াটি মেটাডেটা আইডির আপডেট করা বৈশিষ্ট্য এবং ডেটা উভয়ই ফেরত দেয়।

অনুরোধ

{
  "data": [
    {
      "dataFilter": {
        "developerMetadataLookup": {
          "metadataId": METADATA_ID
        }
      },
      "majorDimension": "ROWS",
      "values": [
        [
          "W-24",
          "84"
        ]
      ]
    }
  ],
  "includeValuesInResponse": true,
  "valueInputOption": "USER_ENTERED"
}

প্রতিক্রিয়া

{
  "spreadsheetId": SPREADSHEET_ID,
  "totalUpdatedRows": 1,
  "totalUpdatedColumns": 2,
  "totalUpdatedCells": 2,
  "totalUpdatedSheets": 1,
  "responses": [
    {
      "updatedRange": "Sheet7!A7:B7",
      "updatedRows": 1,
      "updatedColumns": 2,
      "updatedCells": 2,
      "dataFilter": {
        "developerMetadataLookup": {
          "metadataId": METADATA_ID
        }
      },
      "updatedData": {
        "range": "Sheet7!A7:Z7",
        "majorDimension": "ROWS",
        "values": [
          [
            "W-24",
            "84"
          ]
        ]
      }
    }
  ]
}

মেটাডেটা অনুসারে মানগুলি সাফ করুন

নির্দিষ্ট মেটাডেটার সাথে মিলে যাওয়া সেল মানগুলি সাফ করতে, spreadsheets.values.batchClearByDataFilter পদ্ধতিটি ব্যবহার করুন। আপনি যে মেটাডেটা সাফ করতে চান তা নির্বাচন করতে আপনাকে একটি ডেটা ফিল্টার নির্দিষ্ট করতে হবে।

অনুরোধ

এই উদাহরণে, আমরা অনুরোধে মেটাডেটা আইডি প্রদান করি। প্রতিক্রিয়াটি স্প্রেডশিট আইডি এবং সাফ করা রেঞ্জগুলি ফেরত দেয়।

{
  "dataFilters": [
    {
      "developerMetadataLookup": {
        "metadataId": METADATA_ID
      }
    }
  ]
}

প্রতিক্রিয়া

{
  "spreadsheetId": SPREADSHEET_ID,
  "clearedRanges": [
    "Sheet7!A7:Z7"
  ]
}

মেটাডেটা স্টোরেজ সীমা

একটি স্প্রেডশিটে আপনি মোট কত মেটাডেটা সংরক্ষণ করতে পারবেন তার একটি সীমা রয়েছে। এই সীমা অক্ষরে পরিমাপ করা হয় এবং দুটি উপাদান নিয়ে গঠিত:

আইটেম	স্টোরেজ সীমা বরাদ্দ
স্প্রেডশিট	৩০,০০০ অক্ষর
একটি স্প্রেডশিটের মধ্যে প্রতিটি শীট	৩০,০০০ অক্ষর

আপনি স্প্রেডশিটের জন্য ৩০,০০০ অক্ষর পর্যন্ত সংরক্ষণ করতে পারবেন। এছাড়াও, আপনি একটি স্প্রেডশিটের মধ্যে প্রতিটি শিটের জন্য ৩০,০০০ অক্ষর সংরক্ষণ করতে পারবেন (প্রথম শিটের জন্য ৩০,০০০, দ্বিতীয় শিটের জন্য ৩০,০০০, ইত্যাদি)। সুতরাং তিনটি শিটের একটি স্প্রেডশিটে ১২০,০০০ অক্ষর পর্যন্ত মেটাডেটা থাকতে পারে।

spreadsheets.developerMetadata রিসোর্সের metadataKey এবং metadataValue ক্ষেত্রের প্রতিটি অক্ষর এই সীমার মধ্যে গণনা করা হয়।

সম্পর্কিত বিষয়

• আপনার Google Sheets ডেটাতে ফিল্টার প্রয়োগ করুন
• ফিল্টার ব্যবহার করে ডেটা দৃশ্যমানতা পরিচালনা করুন
• ব্যবহারের সীমা