- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- ModifyLabelsRequest
- LabelModification
- FieldModification
- Wypróbuj
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 |
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 ( |
Pola | |
---|---|
modifiedLabels[] |
Lista etykiet, które zostały dodane lub zaktualizowane w wyniku żądania. |
kind |
To zawsze |
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 ( |
Pola | |
---|---|
labelModifications[] |
Lista zmian, które mają zostać zastosowane do etykiet w pliku. |
kind |
To zawsze |
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 ( |
Pola | |
---|---|
labelId |
Identyfikator etykiety do zmodyfikowania. |
fieldModifications[] |
Lista modyfikacji pól tej etykiety. |
removeLabel |
Jeśli ma wartość prawda, etykieta zostanie usunięta z pliku. |
kind |
To zawsze |
FieldModification
Modyfikacja pola etykiety.
Zapis JSON |
---|
{ "fieldId": string, "kind": string, "setDateValues": [ string ], "setTextValues": [ string ], "setSelectionValues": [ string ], "setIntegerValues": [ string ], "setUserValues": [ string ], "unsetValues": boolean } |
Pola | |
---|---|
fieldId |
Identyfikator pola do zmodyfikowania. |
kind |
To zawsze |
setDateValues[] |
Zastępuje wartość pola |
setTextValues[] |
Ustawia wartość pola |
setSelectionValues[] |
Zastępuje pole |
setIntegerValues[] |
Zastępuje wartość pola |
setUserValues[] |
Zastępuje pole |
unsetValues |
Usuwa wartości tego pola. |