Method: labels.get

Obtiene una etiqueta por su nombre de recurso. Para obtener más información, consulta Cómo buscar etiquetas.

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 publicada actual de la etiqueta.
  • labels/{id}@{revisionId}: Obtiene la etiqueta en el ID de revisión especificado.

Solicitud HTTP

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

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

Parámetros de ruta de acceso

Parámetros
name

string

Es obligatorio. Es el nombre del recurso de la etiqueta.

Puede ser cualquiera de los siguientes:

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

Parámetros de consulta

Parámetros
useAdminAccess

boolean

Se debe establecer en true para usar las credenciales de administrador del usuario. El servidor verifica que el usuario sea administrador de la etiqueta antes de permitir el acceso.
languageCode

string

Es el código de idioma BCP-47 que se usará para evaluar las etiquetas de campo localizadas. Cuando no se especifica, se usan los valores del idioma configurado predeterminado.
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.

Alcances de autorización

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