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

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

ফিল্ড মাস্ক ব্যবহার না করলে এবং ফিল্ড মাস্ক ব্যবহার করলে রেসপন্স বডিতে কী ফিরে আসে তার তুলনা করার জন্য, আংশিক সম্পদের সাথে কাজ করা দেখুন।

ফিল্ড মাস্ক পরে পড়ুন

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

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

নিম্নলিখিত presentations.get পদ্ধতির অনুরোধের উদাহরণে slides.pageElements(objectId,size,transform) এর একটি ফিল্ড মাস্ক ব্যবহার করা হয়েছে যাতে একটি উপস্থাপনার সমস্ত স্লাইডে শুধুমাত্র pageElement অবজেক্টের অবজেক্ট ID, Size এবং transform আনা যায়:

GET https://slides.googleapis.com/v1/presentations/presentationId?fields=slides.pageElements(objectId,size,transform)

এই মেথড কলের প্রতিক্রিয়া হল একটি presentations অবজেক্ট যাতে ফিল্ড মাস্কে অনুরোধ করা উপাদানগুলি থাকে:

{
  "slides": [
    {
      "pageElements": [
        {
          "objectId": "OBJECT_ID",
          "size": {
            "width": {
              "magnitude": 3000000,
              "unit": "EMU"
            },
            "height": {
              "magnitude": 3000000,
              "unit": "EMU"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1
            "translateX": 311708,
            "translateY": 744575,
            "unit": "EMU"
          }
        },
        {
          "objectId": "OBJECT_ID",
          "size": {
            "width": {
              "magnitude": 3000000,
              "unit": "EMU"
            },
            "height": {
              "magnitude": 3000000,
              "unit": "EMU"
            }
          },
          "transform": {
            "scaleX": 1,
            "scaleY": 1
            "translateX": 311700,
            "translateY": 2834125,
            "unit": "EMU"
          }
        }
     ]
    }
  ]
}

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

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

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

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

নিচের উদাহরণে UpdateShapePropertiesRequest পদ্ধতি ব্যবহার করে একটি আকৃতির রঙ পূরণকে DARK1 থিমের রঙে পরিবর্তন করা হয় এবং আকৃতির রূপরেখা আনসেট করা হয়:

POST https://slides.googleapis.com/v1/presentations/presentationId:batchUpdate

{
  "requests": [
    {
      "updateShapeProperties": {
        "objectId": OBJECT_ID,
        "shapeProperties": {
          "shapeBackgroundFill": {
            "solidFill": {
              "color": {
                "themeColor": "DARK1"
              }
            }
          }
        },
        "fields": "shapeBackgroundFill.solidFill.color,outline"
      }
    }
  ]
}