Method: labels.list

Elenca le etichette. Per ulteriori informazioni, consulta Cercare le etichette.

Richiesta HTTP

GET https://drivelabels.googleapis.com/v2/labels

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
publishedOnly

boolean

Indica se includere solo le etichette pubblicate nei risultati.

  • Quando true, vengono restituite solo le revisioni dell'etichetta pubblicata corrente. Sono incluse le etichette disattivate. I nomi delle risorse delle etichette restituite fanno riferimento alla revisione pubblicata (labels/{id}/{revisionId}).
  • Quando false, vengono restituite le revisioni correnti dell'etichetta, che potrebbero non essere pubblicate. I nomi delle risorse delle etichette restituite non fanno riferimento a una revisione specifica (labels/{id}).
customer

string

Il cliente a cui limitare l'ambito di questa richiesta di elenco. Ad esempio: customers/abcd1234. Se non viene impostato, verranno restituite tutte le etichette del cliente attuale.
languageCode

string

Il codice lingua BCP-47 da utilizzare per valutare le etichette dei campi localizzate. Se non specificati, vengono utilizzati i valori nella lingua predefinita configurata.
pageSize

integer

Il numero massimo di etichette da restituire per pagina. Valore predefinito: 50. Max: 200.
pageToken

string

Il token della pagina da restituire.
view

enum (LabelView)

Se specificati, vengono restituiti solo determinati campi appartenenti alla visualizzazione indicata.

Parametro di unione access.

access può essere solo uno dei seguenti:
useAdminAccess

boolean

Imposta su true per utilizzare le credenziali di amministratore dell'utente. Verranno restituite tutte le etichette all'interno del cliente.
minimumRole

enum (LabelRole)

Specifica il livello di accesso che l'utente deve avere alle etichette restituite. Il ruolo minimo che un utente deve avere per un'etichetta. Il valore predefinito è READER.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta per le etichette delle schede.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "labels": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string
}
Campi
labels[]

object (Label)

Etichette.
nextPageToken

string

Il token della pagina successiva nella risposta.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.labels.readonly
  • https://www.googleapis.com/auth/drive.admin.labels
  • https://www.googleapis.com/auth/drive.admin.labels.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.