Method: files.listLabels

Lista os rótulos em um arquivo.

Solicitação HTTP

GET https://www.googleapis.com/drive/v3/files/{fileId}/listLabels

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
fileId

string

O ID do arquivo.

Parâmetros de consulta

Parâmetros
maxResults

integer

O número máximo de rótulos a serem retornados por página. Quando não definido, o padrão é 100.

pageToken

string

O token para continuar uma solicitação de lista anterior na próxima página. Ele deve ser definido como o valor de "nextPageToken". da resposta anterior.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Uma lista de marcadores aplicados a um arquivo.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "labels": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
Campos
labels[]

object (Label)

A lista de marcadores.

nextPageToken

string

O token da próxima página de rótulos. Esse campo não vai aparecer se o fim da lista for alcançado. Se o token for rejeitado por qualquer motivo, ele deverá ser descartado e a paginação deverá ser reiniciada na primeira página de resultados. O token de página costuma ser válido por várias horas. No entanto, se novos itens forem adicionados ou removidos, os resultados esperados poderão ser diferentes.

kind

string

É sempre drive#labelList

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

Alguns escopos são restritos e exigem uma avaliação de segurança para serem usados pelo app. Para mais informações, consulte o Guia de autorização.