फ़ील्ड मास्क का इस्तेमाल करना

फ़ील्ड मास्क एक ऐसा तरीका है जिसकी मदद से एपीआई कॉल करने वाले, अनुरोध किए जाने वाले फ़ील्ड की सूची बना सकते हैं वापस लौटाने या अपडेट करने के लिए. इसका इस्तेमाल करके FieldMask इसकी मदद से, एपीआई को गैर-ज़रूरी काम से बचने और परफ़ॉर्मेंस को बेहतर बनाने में मदद मिलती है. फ़ील्ड मास्क का इस्तेमाल Google Slides API में, पढ़ने और अपडेट करने के तरीकों में किया जाता है.

फ़ील्ड मास्क की मदद से पढ़ना

प्रस्तुतियाँ बड़ी हो सकती हैं और अक्सर आपको Presentation पढ़ने के अनुरोध से मिला संसाधन. आप यह तय कर सकते हैं कि fields यूआरएल पैरामीटर का इस्तेमाल करके, Slides API का रिस्पॉन्स. सर्वश्रेष्ठ के लिए परफ़ॉर्मेंस, साफ़ तौर पर सिर्फ़ उन फ़ील्ड की जानकारी दें जिनकी आपको ज़रूरत है जवाब में.

फ़ील्ड पैरामीटर का फ़ॉर्मैट वही होता है जो FieldMask की JSON एन्कोडिंग. संक्षेप में, कई अलग-अलग फ़ील्ड कॉमा लगाकर अलग किए गए होते हैं और सबफ़ील्ड डॉट से अलग किया हुआ. फ़ील्ड के नाम camelCase में दिए जा सकते हैं या separated_by_underscores. सुविधा के लिए, एक ही प्रॉपर्टी से कई सबफ़ील्ड टाइप को ब्रैकेट में रखा जा सकता है.

presentations.get अनुरोध का उदाहरण सिर्फ़ ऑब्जेक्ट आईडी फ़ेच करने के लिए slides.pageElements(objectId,size,transform), Size, और बदलें pageElement में से प्रज़ेंटेशन में सभी स्लाइड पर ऑब्जेक्ट:

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 कार्रवाई, फ़ील्ड मास्क का इस्तेमाल करके एपीआई को बताती है कि कौनसे फ़ील्ड बदले जा रहे हैं. कॉन्टेंट बनाने अपडेट करने का अनुरोध उन फ़ील्ड पर ध्यान नहीं देता जिन्हें फ़ील्ड मास्क में तय नहीं किया गया है, उन्हें उनकी मौजूदा वैल्यू के साथ बनाए रखते हैं.

अपडेट किए गए मैसेज में किसी फ़ील्ड की जानकारी न देकर भी, उसे अनसेट किया जा सकता है. हालांकि, मास्क में फ़ील्ड जोड़ना. इससे फ़ील्ड की पहले से तय की गई वैल्यू हट जाती है किया है.

अपडेट फ़ील्ड मास्क का सिंटैक्स और रीड फ़ील्ड मास्क एक जैसे होते हैं.

नीचे दिए गए उदाहरण में 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"
      }
    }
  ]
}