อ่าน เขียน และค้นหาข้อมูลเมตา

ฟีเจอร์ข้อมูลเมตาช่วยให้คุณเชื่อมโยงข้อมูลเมตากับเอนทิตีและ ตำแหน่งต่างๆ ในสเปรดชีตได้ จากนั้นคุณจะค้นหาข้อมูลเมตานี้และใช้เพื่อค้นหา ออบเจ็กต์ที่เชื่อมโยงกับข้อมูลเมตานี้ได้

คุณเชื่อมโยงข้อมูลเมตากับแถว คอลัมน์ ชีต หรือสเปรดชีตได้

เกี่ยวกับข้อมูลเมตา

ต่อไปนี้คือแง่มุมสำคัญบางประการของข้อมูลเมตาที่คุณควรพิจารณา เมื่อทำงานกับชีต API

1. ข้อมูลเมตาเป็นแท็ก: การใช้ข้อมูลเมตาของนักพัฒนาแอปอย่างหนึ่งคือแท็กที่ตั้งชื่อ ตำแหน่งในสเปรดชีตโดยใช้เพียงคีย์และตำแหน่ง เช่น คุณสามารถเชื่อมโยง headerRow กับแถวที่เฉพาะเจาะจงหรือ totals กับคอลัมน์ที่เฉพาะเจาะจงภายในชีตได้ คุณใช้แท็กเพื่อเชื่อมโยงส่วนต่างๆ ของสเปรดชีตกับฟิลด์ในเครื่องมือหรือฐานข้อมูลของบุคคลที่สามในเชิงความหมายได้ เพื่อให้การเปลี่ยนแปลงในสเปรดชีตไม่ทำให้แอปใช้งานไม่ได้

2. ข้อมูลเมตาเป็นพร็อพเพอร์ตี้: ข้อมูลเมตาที่สร้างขึ้นโดยการระบุคีย์ สถานที่ และค่าจะทำหน้าที่เป็นคู่คีย์-ค่าที่เชื่อมโยงกับสถานที่นั้นในชีต ตัวอย่างเช่น คุณสามารถเชื่อมโยงสิ่งต่อไปนี้ได้

   • formResponseId = resp123 ที่มีแถว
   • lastUpdated = 1477369882 ที่มีคอลัมน์

   ซึ่งช่วยให้คุณจัดเก็บและเข้าถึงพร็อพเพอร์ตี้ที่กำหนดเองซึ่งเชื่อมโยงกับ พื้นที่หรือข้อมูลที่เฉพาะเจาะจงในสเปรดชีตได้

3. ข้อมูลเมตาที่มองเห็นได้ของโปรเจ็กต์เทียบกับเอกสาร: เพื่อป้องกันไม่ให้โปรเจ็กต์ของนักพัฒนาซอฟต์แวร์รายหนึ่งรบกวนข้อมูลเมตาของอีกรายหนึ่ง จึงมีข้อมูลเมตา 2 รายการ visibility การตั้งค่า: project และ document เมื่อใช้ชีต API project คุณจะดูและเข้าถึงข้อมูลเมตาได้จากโปรเจ็กต์ Google Cloud ที่สร้างข้อมูลเมตานั้นเท่านั้น document ข้อมูลเมตาจะเข้าถึงได้จากโปรเจ็กต์ Google Cloud ใดก็ได้ที่มีสิทธิ์เข้าถึงเอกสาร

   การค้นหาที่ไม่ได้ระบุvisibilityข้อมูลเมตาที่ตรงกันdocumentอย่างชัดเจนจะแสดงข้อมูลเมตาที่ตรงกันและข้อมูลเมตาที่ตรงกันสำหรับโปรเจ็กต์ Google Cloud ที่ส่งคำขอproject

   อย่าใช้ข้อมูลเมตาของนักพัฒนาแอปที่มองเห็นได้ในโปรเจ็กต์เป็นกลไกด้านความปลอดภัยหรือเพื่อจัดเก็บข้อมูลลับ ระบบอาจแสดงข้อมูลเมตาต่อผู้ใช้ที่มีสิทธิ์เข้าถึงเอกสาร

4. ความไม่ซ้ำกัน: คีย์ข้อมูลเมตาไม่จำเป็นต้องไม่ซ้ำกัน แต่ metadataId ต้องแตกต่างกัน หากคุณสร้างข้อมูลเมตาและปล่อยให้ฟิลด์รหัสว่างไว้ API จะกำหนดรหัสให้ รหัสนี้ใช้เพื่อระบุข้อมูลเมตาได้ ส่วนคีย์และแอตทริบิวต์อื่นๆ ใช้เพื่อระบุชุดข้อมูลเมตาได้

   แม้ว่าคุณจะระบุ `metadataId` ของคุณเองได้เมื่อสร้างข้อมูลเมตา แต่เราขอแนะนำให้คุณอนุญาตให้ชีต API กำหนดให้คุณ

5. ส่งคืนข้อมูลเมตาผ่านคำขอ API: ออบเจ็กต์ A DataFilter เป็นส่วนหนึ่งของการเรียก API ที่อธิบายข้อมูลที่จะเลือกหรือส่งคืนจากคำขอ API

   DataFilter ออบเจ็กต์เดียวระบุเกณฑ์ตัวกรองได้เพียงประเภทเดียวเพื่อค้นหาข้อมูล

   • developerMetadataLookup: เลือกข้อมูลที่เชื่อมโยงกับข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่ระบุซึ่งตรงกับเกณฑ์

   • a1Range: เลือกข้อมูลที่ตรงกับช่วงรูปแบบ A1 ที่ระบุ เช่น Sheet1!A1:B10

   • gridRange: เลือกข้อมูลที่ตรงกับช่วงตารางกริดที่ระบุโดยใช้ดัชนีที่อิงตาม 0 เช่น Sheet1!A3:B4 == sheetId: 123456, startRowIndex: 2, endRowIndex: 4, startColumnIndex: 0, endColumnIndex: 2

   หากต้องการกรองตามสถานที่ตั้งหรือเกณฑ์หลายรายการ คุณสามารถใช้ ออบเจ็กต์ DataFilter หลายรายการในคำขอ API เดียวได้ ระบุอาร์เรย์หรือลิสต์ของออบเจ็กต์ DataFilter ไปยังคำขอแบบกลุ่ม เช่น เมธอด spreadsheets.values.batchGetByDataFilter ระบบจะแสดงหรือแก้ไขช่วงที่ตรงกับตัวกรองข้อมูลใดๆ ในคำขอ

   ดูข้อมูลเพิ่มเติมได้ที่อ่านและเขียนค่าที่เชื่อมโยงกับข้อมูลเมตา

กรณีการใช้งาน

ตัวอย่างกรณีการใช้งานบางส่วนสำหรับการจัดการข้อมูลเมตามีดังนี้

• เชื่อมโยงข้อมูลที่กำหนดเองกับเอนทิตีและสถานที่ต่างๆ ในสเปรดชีต เช่น เชื่อมโยง totals กับคอลัมน์ D หรือ responseId = 1234 กับแถว 7

• ค้นหาสถานที่และข้อมูลทั้งหมดที่เชื่อมโยงกับคีย์ข้อมูลเมตาหรือแอตทริบิวต์ใดหนึ่ง: เช่น หากมีคีย์ totals ที่เชื่อมโยงกับคอลัมน์ D หรือหากมี responseId ให้แสดงแถวทั้งหมดที่มีข้อมูลเมตา responseId และค่าข้อมูลเมตาที่เชื่อมโยงกับแถวดังกล่าว

• ค้นหาข้อมูลทั้งหมดที่เชื่อมโยงกับเอนทิตีหรือสถานที่ตั้งหนึ่งๆ: เช่น หากมีคอลัมน์ D ให้แสดงข้อมูลเมตาทั้งหมดที่เชื่อมโยงกับสถานที่ตั้งนั้น

• ดึงค่าในตำแหน่งโดยการระบุข้อมูลเมตาที่เชื่อมโยง: เช่น เมื่อระบุ totals ให้แสดงค่าที่อยู่ในคอลัมน์หรือแถวที่เชื่อมโยง หรือเมื่อระบุ summary ให้แสดงทรัพยากรชีตที่เชื่อมโยง

• อัปเดตค่าในตำแหน่งโดยระบุข้อมูลเมตาที่เชื่อมโยง: เช่น แทนที่จะอัปเดตค่าในแถวผ่านรูปแบบ A1 ให้อัปเดตค่า โดยระบุรหัสข้อมูลเมตา

อ่านและเขียนข้อมูลเมตา

spreadsheets.developerMetadata ทรัพยากรนี้ให้สิทธิ์เข้าถึงข้อมูลเมตาที่เชื่อมโยงกับสถานที่หรือออบเจ็กต์ในสเปรดชีต คุณใช้ข้อมูลเมตาของนักพัฒนาซอฟต์แวร์เพื่อเชื่อมโยงข้อมูลที่กำหนดเองกับส่วนต่างๆ ของสเปรดชีตได้ ข้อมูลเมตาจะยังคงเชื่อมโยงกับตำแหน่งเหล่านั้นเมื่อมีการแก้ไขสเปรดชีต

สร้างข้อมูลเมตา

หากต้องการสร้างข้อมูลเมตา ให้ใช้วิธี batchUpdate ในทรัพยากร spreadsheets และระบุ CreateDeveloperMetadataRequest ที่มีค่า metadataKey, location และ visibility จากทรัพยากร spreadsheets.developerMetadata คุณจะระบุ 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 โดยระบุรหัสข้อมูลเมตาที่ลบ คุณควรได้รับการตอบกลับรหัสสถานะ HTTP 404: Not Found พร้อมข้อความที่ระบุว่า "ไม่มีข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่มีรหัส 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 คุณต้องระบุรหัสสเปรดชีตและตัวกรองข้อมูลอย่างน้อย 1 รายการที่ ตรงกับข้อมูลเมตา

ในตัวอย่างนี้ เราจะระบุรหัสข้อมูลเมตาในคำขอ การตอบกลับจะแสดงค่าเซลล์แถว (หมายเลขรุ่น ยอดขายรายเดือน) สำหรับรหัสข้อมูลเมตา

คำขอ

{
  "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 คุณต้องระบุรหัสสเปรดชีตและตัวกรองข้อมูลอย่างน้อย 1 รายการที่ ตรงกับข้อมูลเมตา

คำขอนี้ทําหน้าที่เป็นคําขอ "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 อย่างน้อย 1 ค่าที่ตรงกับข้อมูลเมตา

ในตัวอย่างนี้ เราจะระบุรหัสข้อมูลเมตาและค่าแถวที่อัปเดตแล้วในคำขอ การตอบกลับจะแสดงทั้งพร็อพเพอร์ตี้ที่อัปเดตและข้อมูลสำหรับรหัสข้อมูลเมตา

คำขอ

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

ขีดจำกัดพื้นที่เก็บข้อมูลของข้อมูลเมตา

เราจำกัดจำนวนข้อมูลเมตาที่คุณจัดเก็บไว้ในสเปรดชีตได้ โดยขีดจำกัดนี้วัดเป็นอักขระและประกอบด้วย 2 องค์ประกอบต่อไปนี้

รายการ	การจัดสรรโควต้าพื้นที่เก็บข้อมูล
สเปรดชีต	30,000 อักขระ
ชีตแต่ละชีตในสเปรดชีต	30,000 อักขระ

คุณจัดเก็บอักขระสำหรับสเปรดชีตได้สูงสุด 30,000 ตัว นอกจากนี้ คุณยังจัดเก็บอักขระได้ 30,000 ตัวสำหรับแต่ละชีตภายในสเปรดชีต (30,000 สำหรับชีต 1, 30,000 สำหรับชีต 2 และอื่นๆ) ดังนั้นสเปรดชีตที่มี 3 ชีต จึงมีข้อมูลเมตาได้สูงสุด 120,000 อักขระ

อักขระแต่ละตัวในช่อง metadataKey และ metadataValue ของทรัพยากร spreadsheets.developerMetadata จะนับรวมในขีดจำกัดนี้

หัวข้อที่เกี่ยวข้อง

• ใช้ตัวกรองกับข้อมูล Google ชีต
• จัดการระดับการมองเห็นข้อมูลด้วยตัวกรอง
• โควต้าการใช้งาน