Method: labels.get

Obtén una etiqueta por su nombre de recurso. El nombre del recurso puede ser cualquiera de los siguientes:

  • labels/{id} - Consulta labels/{id}@latest
  • labels/{id}@latest: Obtiene la revisión más reciente de la etiqueta.
  • labels/{id}@published: Obtiene la revisión actual publicada de la etiqueta.
  • labels/{id}@{revisionId}: Obtiene la etiqueta en el ID de revisión especificado.

Solicitud HTTP

GET https://drivelabels.googleapis.com/v2beta/{name=labels/*}

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
name

string

Obligatorio. Es el nombre del recurso de etiqueta.

Puede ser cualquiera de las siguientes opciones:

  • labels/{id} (equivalente a etiquetas/{id}@latest)
  • labels/{id}@latest
  • labels/{id}@published
  • labels/{id}@{revisionId}

Parámetros de consulta

Parámetros
useAdminAccess

boolean

Configúralo como true para usar las credenciales de administrador del usuario. El servidor verifica que el usuario sea un administrador de la etiqueta antes de permitir el acceso.
languageCode

string

Es el código de idioma BCP-47 que se debe usar para evaluar etiquetas de campo localizadas. Si no se especifica, se usarán los valores en el idioma predeterminado configurado.
view

enum (LabelView)

Cuando se especifica, solo se muestran ciertos campos que pertenecen a la vista indicada.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Label.

Permisos de autorización

Se necesita uno de los siguientes alcances de 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

Para obtener más información, consulta la guía de autorización.