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/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. Obejmuje to tylko etykiety 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 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ą objęte ograniczeniami, a aplikacja może z nich korzystać dopiero po sprawdzeniu zabezpieczeń. Więcej informacji znajdziesz w przewodniku po autoryzacji.

ModifyLabelsRequest

Żądanie zmiany zestawu etykiet w pliku. To żądanie może zawierać wiele modyfikacji, które zakończą się powodzeniem lub niepowodzeniem atomowo.

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

object (LabelModification)

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

string

Jest to zawsze drive#modifyLabelsRequest.

LabelModification

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

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

string

Identyfikator etykiety do zmiany.
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

Jest to zawsze drive#labelFieldModification.
setDateValues[]

string

Zastępuje wartość w polu date tymi nowymi wartościami. Ciąg musi być w pełnym formacie 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ść w polu integer tymi nowymi wartościami.
setUserValues[]

string

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

boolean

Anuluje ustawienie wartości w tym polu.