Method: files.modifyLabels

ファイルに適用されているラベルのセットを変更します。追加または変更されたラベルのリストを返します。

HTTP リクエスト

POST https://www.googleapis.com/drive/v2/files/{fileId}/modifyLabels

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
fileId

string

ラベルが属するファイルの ID。

リクエスト本文

リクエストの本文には ModifyLabelsRequest のインスタンスが含まれています。

レスポンスの本文

files.modifyLabels リクエストに対するレスポンス。これには、リクエストによって追加または更新されたラベルのみが含まれます。

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現 
{
  "modifiedLabels": [
    {
      object (Label)
    }
  ],
  "kind": string
}
フィールド
modifiedLabels[]

object (Label)

リクエストによって追加または更新されたラベルのリスト。
kind

string

常に drive#modifyLabelsResponse です

認可スコープ

次の OAuth スコープのいずれかが必要です。

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata

一部のスコープは制限されているため、アプリで使用するにはセキュリティ評価が必要です。詳細については、承認ガイドをご覧ください。

ModifyLabelsRequest

ファイルのラベルセットを変更するリクエスト。このリクエストには多数の変更が含まれる可能性があり、それらすべてが成功するか、アトミックに失敗するかのいずれかになります。

JSON 表現 
{
  "labelModifications": [
    {
      object (LabelModification)
    }
  ],
  "kind": string
}
フィールド
labelModifications[]

object (LabelModification)

ファイルのラベルに適用する変更のリスト。
kind

string

これは常に drive#modifyLabelsRequest です。

LabelModification

ファイルのラベルに対する変更。LabelModification を使用して、ファイルへのラベルの適用、ファイルの既存のラベルの更新、ファイルからのラベルの削除を行うことができます。

JSON 表現 
{
  "labelId": string,
  "fieldModifications": [
    {
      object (FieldModification)
    }
  ],
  "removeLabel": boolean,
  "kind": string
}
フィールド
labelId

string

変更するラベルの ID。
fieldModifications[]

object (FieldModification)

このラベルのフィールドに対する変更のリスト。
removeLabel

boolean

true の場合、ファイルからラベルが削除されます。
kind

string

これは常に drive#labelModification です。

FieldModification

ラベルのフィールドの変更。

JSON 表現 
{
  "fieldId": string,
  "kind": string,
  "setDateValues": [
    string
  ],
  "setTextValues": [
    string
  ],
  "setSelectionValues": [
    string
  ],
  "setIntegerValues": [
    string
  ],
  "setUserValues": [
    string
  ],
  "unsetValues": boolean
}
フィールド
fieldId

string

変更するフィールドの ID。
kind

string

これは常に drive#labelFieldModification です。
setDateValues[]

string

date フィールドの値を新しい値に置き換えます。文字列は、RFC 3339 の完全日付形式（YYYY-MM-DD）で指定する必要があります。
setTextValues[]

string

text フィールドの値を設定します。
setSelectionValues[]

string

selection フィールドを新しい値に置き換えます。
setIntegerValues[]

string (int64 format)

integer フィールドの値を新しい値に置き換えます。
setUserValues[]

string

user フィールドを新しい値に置き換えます。値は有効なメールアドレスにする必要があります。
unsetValues

boolean

このフィールドの値の設定を解除します。