ModifyLabelsRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/google/main/json-schema/google-modify-labels-request-schema.json",
  "title": "ModifyLabelsRequest",
  "description": "A request to modify the set of labels on a file. This request may contain many modifications that will either all succeed or all fail atomically.",
  "x-generated": "2026-10-03",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-files-api-openapi.yml#/components/schemas/ModifyLabelsRequest",
  "properties": {
    "kind": {
      "description": "This is always drive#modifyLabelsRequest.",
      "type": "string"
    },
    "labelModifications": {
      "description": "The list of modifications to apply to the labels on the file.",
      "items": {
        "$ref": "#/$defs/LabelModification"
      },
      "type": "array"
    }
  },
  "type": "object",
  "$defs": {
    "LabelFieldModification": {
      "description": "A modification to a label's field.",
      "properties": {
        "fieldId": {
          "description": "The ID of the field to be modified.",
          "type": "string"
        },
        "kind": {
          "description": "This is always drive#labelFieldModification.",
          "type": "string"
        },
        "setDateValues": {
          "description": "Replaces the value of a dateString Field with these new values. The string must be in the RFC 3339 full-date format: YYYY-MM-DD.",
          "items": {
            "format": "date",
            "type": "string"
          },
          "type": "array"
        },
        "setIntegerValues": {
          "description": "Replaces the value of an `integer` field with these new values.",
          "items": {
            "format": "int64",
            "type": "string"
          },
          "type": "array"
        },
        "setSelectionValues": {
          "description": "Replaces a `selection` field with these new values.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "setTextValues": {
          "description": "Sets the value of a `text` field.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "setUserValues": {
          "description": "Replaces a `user` field with these new values. The values must be valid email addresses.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "unsetValues": {
          "description": "Unsets the values for this field.",
          "type": "boolean"
        }
      },
      "type": "object"
    },
    "LabelModification": {
      "description": "A modification to a label on a file. A LabelModification can be used to apply a label to a file, update an existing label on a file, or remove a label from a file.",
      "properties": {
        "fieldModifications": {
          "description": "The list of modifications to this label's fields.",
          "items": {
            "$ref": "#/$defs/LabelFieldModification"
          },
          "type": "array"
        },
        "kind": {
          "description": "This is always drive#labelModification.",
          "type": "string"
        },
        "labelId": {
          "description": "The ID of the label to modify.",
          "type": "string"
        },
        "removeLabel": {
          "description": "If true, the label will be removed from the file.",
          "type": "boolean"
        }
      },
      "type": "object"
    }
  }
}