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 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/v2beta/{name=labels/*}

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

Parámetros de ruta de acceso

Parámetros
name

string

Obligatorio. Etiqueta el nombre del recurso.

Puede ser cualquiera de las siguientes opciones:

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

Parámetros de consulta

Parámetros
useAdminAccess

boolean

Establece este valor 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. Si no se especifican, se usan los valores del 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.

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.