Method: files.modifyLabels

Modyfikuje zestaw etykiet zastosowanych do 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.modifylabel. Obejmuje to tylko te etykiety, które zostały dodane lub zaktualizowane w odpowiedzi na żądanie.

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 wyniku żądania.

kind

string

To zawsze jest drive#modifyLabelResponse

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu 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. Aby można było z nich korzystać, aplikacja musi przeprowadzić ocenę zabezpieczeń. Więcej informacji znajdziesz w przewodniku na temat autoryzacji.

ModifyLabelsRequest

Żądanie zmiany zestawu etykiet pliku. To żądanie może zawierać wiele modyfikacji, które zakończą się sukcesem lub będą niepowodzenie w poszczególnych częściach.

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

object (LabelModification)

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

kind

string

Jest to zawsze drive#modifyEtykietyRequest.

LabelModification

Modyfikacja etykiety pliku. Za pomocą zmiany LabelModification można zastosować etykietę do pliku, zaktualizować istniejącą etykietę lub usunąć etykietę z pliku.

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

string

Identyfikator etykiety do zmodyfikowania.

fieldModifications[]

object (FieldModification)

Lista modyfikacji pól tej etykiety.

removeLabel

boolean

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

kind

string

Jest to zawsze drive#labelModification.

FieldModification

Modyfikacja pola etykiety.

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

string

Identyfikator pola do zmodyfikowania.

kind

string

To zawsze jest drive#labelFieldModification.

setDateValues[]

string

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

setTextValues[]

string

Ustawia wartość pola text.

setSelectionValues[]

string

Zastępuje pole selection nowymi wartościami.

setIntegerValues[]

string (int64 format)

Zastępuje wartość pola integer nowymi wartościami.

setUserValues[]

string

Zastępuje pole user nowymi wartościami. Wartościami muszą być prawidłowe adresy e-mail.

unsetValues

boolean

Usuwa wartości tego pola.