এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

ফিল্ড মাস্ক ব্যবহার করুন, ফিল্ড মাস্ক ব্যবহার করুন
সেভ করা পৃষ্ঠা গুছিয়ে রাখতে 'সংগ্রহ' ব্যবহার করুন আপনার পছন্দ অনুযায়ী কন্টেন্ট সেভ করুন ও সঠিক বিভাগে রাখুন।

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

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

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

উপস্থাপনাগুলি বড় হতে পারে, এবং প্রায়শই আপনার একটি পড়ার অনুরোধের মাধ্যমে ফিরে আসা presentations সংস্থানের প্রতিটি অংশের প্রয়োজন হয় না। আপনি 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)

এই পদ্ধতি কলের প্রতিক্রিয়া হল একটি 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 কে জানাতে ফিল্ড মাস্ক ব্যবহার করে কোন ক্ষেত্রগুলি পরিবর্তন করা হচ্ছে৷ হালনাগাদ অনুরোধ ফিল্ড মাস্কে নির্দিষ্ট করা নেই এমন কোনো ক্ষেত্রকে উপেক্ষা করে, তাদের বর্তমান মানগুলি রেখে দেয়।

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

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

* এর একটি ফিল্ড মাস্ককে ওয়াইল্ডকার্ডের মতো বিবেচনা করা হয় এবং একটি বার্তায় প্রতিটি ক্ষেত্র নির্দিষ্ট করার জন্য শর্টহ্যান্ড। ভবিষ্যতে 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"
      }
    }
  ]
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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