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

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

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

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

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

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

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

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

{
  "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"
      }
    }
  ]
}