Method: files.modifyLabels

Modyfikuje 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 przez żą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 przez żądanie.
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 z nich korzystać. Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.

ModifyLabelsRequest

prośba o zmianę zestawu etykiet w pliku. Ta prośba może zawierać wiele modyfikacji, które albo wszystkie się powiodą, albo wszystkie zakończą się niepowodzeniem.

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

object (LabelModification)

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

string

Jest ona zawsze drive#modifyLabelsRequest.

LabelModification

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

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

string

Identyfikator etykiety, którą chcesz zmodyfikować.
fieldModifications[]

object (FieldModification)

Lista modyfikacji pól tej etykiety.
removeLabel

boolean

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

string

Jest ona 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, które chcesz zmodyfikować.
kind

string

Jest ona zawsze drive#labelFieldModification.
setDateValues[]

string

Zastępuje wartość pola date nowymi wartościami. Ciąg znaków musi być w pełnym formacie 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 nowymi wartościami. Wartości muszą być prawidłowymi adresami e-mail.
unsetValues

boolean

anuluje ustawienie wartości w tym polu.