- Żą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/v3/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.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 ( |
Pola | |
---|---|
modifiedLabels[] |
Lista etykiet, które zostały dodane lub zaktualizowane w wyniku żądania. |
kind |
To zawsze jest 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 ( |
Pola | |
---|---|
labelModifications[] |
Lista modyfikacji, które mają być zastosowane do etykiet w pliku. |
kind |
To zawsze jest 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 ( |
Pola | |
---|---|
labelId |
Identyfikator etykiety do zmiany. |
fieldModifications[] |
Lista modyfikacji pól tej etykiety. |
removeLabel |
Jeśli ma wartość prawda, etykieta zostanie usunięta z pliku. |
kind |
To zawsze jest 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 |
Identyfikator pola do zmodyfikowania. |
kind |
To zawsze jest drive#labelFieldModification. |
setDateValues[] |
Zastępuje wartość w polu |
setTextValues[] |
Ustawia wartość pola |
setSelectionValues[] |
Zastępuje pole |
setIntegerValues[] |
Zastępuje wartość w polu |
setUserValues[] |
Zastępuje pole |
unsetValues |
Anuluje ustawienie wartości w tym polu. |