Method: files.modifyLabels

Zmienia zbiór etykiet zastosowanych do pliku. Więcej informacji znajdziesz w artykule Ustawianie pola etykiety w pliku.

Zwraca listę etykiet, które zostały dodane lub zmodyfikowane.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
fileId

string

Identyfikator pliku, do którego należą etykiety.

Treść żądania

Treść żądania zawiera wystąpienie elementu ModifyLabelsRequest.

Treść odpowiedzi

Odpowiedź na żądanie files.modifyLabels. Zawiera tylko te etykiety, które zostały dodane lub zaktualizowane w ramach żądania.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "modifiedLabels": [
    {
      object (Label)
    }
  ],
  "kind": string
}
Pola
modifiedLabels[]

object (Label)

Lista etykiet, które zostały dodane lub zaktualizowane w ramach żądania.
kind

string

Zawsze jest to "drive#modifyLabelsResponse".

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Niektóre zakresy są ograniczone i wymagają oceny bezpieczeństwa, aby aplikacja mogła ich używać. Więcej informacji znajdziesz w przewodniku po autoryzacji.

ModifyLabelsRequest

Prośba o zmianę zestawu etykiet w pliku. Ta prośba może zawierać wiele modyfikacji, które zostaną wykonane w całości lub w całości nie zostaną wykonane.

Zapis JSON 
{
  "labelModifications": [
    {
      object (LabelModification)
    }
  ],
  "kind": string
}
Pola
labelModifications[]

object (LabelModification)

Lista modyfikacji, które mają zostać zastosowane do etykiet w pliku.
kind

string

Zawsze jest to "drive#modifyLabelsRequest".

LabelModification

zmiana etykiety pliku; Za pomocą LabelModification możesz zastosować etykietę do pliku, zaktualizować istniejącą etykietę w pliku lub usunąć etykietę z pliku.

Zapis JSON 
{
  "fieldModifications": [
    {
      object (FieldModification)
    }
  ],
  "labelId": string,
  "removeLabel": boolean,
  "kind": string
}
Pola
fieldModifications[]

object (FieldModification)

Lista modyfikacji pól tej etykiety.
labelId

string

Identyfikator etykiety, którą chcesz zmodyfikować.
removeLabel

boolean

Jeśli ma wartość true, etykieta zostanie usunięta z pliku.
kind

string

Zawsze jest to "drive#labelModification".

FieldModification

Zmiana w polu etykiety.

Zapis JSON 
{
  "setDateValues": [
    string
  ],
  "setTextValues": [
    string
  ],
  "setSelectionValues": [
    string
  ],
  "setIntegerValues": [
    string
  ],
  "setUserValues": [
    string
  ],
  "fieldId": string,
  "kind": string,
  "unsetValues": boolean
}
Pola
setDateValues[]

string

Zastępuje wartość pola date nowymi wartościami. Ciąg znaków musi mieć format pełnej daty RFC 3339: RRRR-MM-DD.
setTextValues[]

string

Ustawia wartość pola text.
setSelectionValues[]

string

Zastępuje pole selection tymi nowymi wartościami.
setIntegerValues[]

string (int64 format)

Zastępuje wartość pola integer nowymi wartościami.
setUserValues[]

string

Zastępuje pole user tymi nowymi wartościami. Wartości muszą być prawidłowymi adresami e-mail.
fieldId

string

Identyfikator pola, które ma zostać zmodyfikowane.
kind

string

Zawsze jest to "drive#labelFieldModification".
unsetValues

boolean

Usuwa wartości tego pola.