Method: files.modifyLabels

Zmienia zbiór etykiet zastosowanych do pliku. Zwraca listę etykiet, które zostały dodane lub zmodyfikowane.

Żądanie HTTP

POST https://www.googleapis.com/drive/v2/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 w sposób atomowy.

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; Obiektu LabelModification można użyć do zastosowania etykiety do pliku, zaktualizowania istniejącej etykiety w pliku lub usunięcia etykiety z pliku.

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

object (FieldModification)

Lista zmian w polach 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.