Esta página se ha traducido con Cloud Translation API.

Conector de Google Drive

El conector de Google Drive te permite crear y configurar una conexión de Google Drive en Integration Connectors. Puedes usar esta conexión en tus aplicaciones empresariales para intercambiar datos de forma segura y realizar operaciones con Google Drive.

Para ver la lista de entidades y operaciones admitidas, consulta Entidades y operaciones admitidas. Para obtener información sobre las acciones específicas de los conectores que se admiten, consulta Acciones admitidas.

Versiones del conector de Google Drive

El conector de Google Drive admite dos versiones:

Google Drive v1: usa esta versión del conector para acceder a la API Google Drive v3.
Google Drive v2: usa esta versión del conector para acceder a la API Google Drive v2.

Para obtener información sobre cómo crear una conexión de Google Drive, consulta Crear y configurar un conector de Google Drive.

Entidades y operaciones admitidas

El conector de Google Drive admite las siguientes entidades y operaciones:

Entidad	Descripción	Operaciones
`File`	Representa un archivo en Google Drive.	`Get`, `List`, `Create`, `Update` y `Delete`
`Folder`	Representa una carpeta de Google Drive.	`Get`, `List`, `Create`, `Update` y `Delete`
`Permission`	Representa un permiso para un archivo o una carpeta de Google Drive.	`Get`, `List`, `Create`, `Update` y `Delete`
`Drive`	Representa una unidad de Google Drive.	`Get`, `List`, `Create`, `Update` y `Delete`

Para ver ejemplos de casos prácticos de Application Integration, consulta Ejemplos de casos prácticos de Application Integration.

Acciones admitidas

El conector de Google Drive admite las siguientes acciones:

CopyResource

Descripción: crea una copia de un recurso especificado en Google Drive. Puedes definir un nuevo nombre para el archivo copiado y especificar su carpeta de destino proporcionando una lista de IDs de carpetas principales .

Parámetros de entrada

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
`Id`	Cadena	Sí	ID del recurso que se va a copiar.
`NewName`	Cadena	Sí	El nuevo nombre del archivo copiado.
`ParentIDs`	Cadena	No	Lista de IDs de carpetas principales separada por comas en la que se colocará el archivo copiado. Si no se especifica, el archivo se copiará en la misma carpeta en la que se encontraba.
`IgnoreDefaultVisibility`	Booleano	No	Determina si se deben omitir los ajustes de visibilidad predeterminados del archivo recién creado. Si el dominio está configurado para que todos los archivos subidos sean visibles de forma predeterminada, al asignar el valor "true" a este parámetro se anula ese comportamiento en esta solicitud específica. El valor predeterminado es false.
`IncludeLabels`	Cadena	No	Lista separada por comas de los IDs de las etiquetas que se incluirán en la parte labelInfo de la respuesta.
`IncludePermissionsForView`	Cadena	Sí	Este campo especifica qué permisos de vista adicionales se deben incluir en la respuesta. Se publica el valor admitido.
`KeepRevisionForever`	Booleano	No	Indica si se deben conservar las revisiones del archivo para siempre. Esta función solo se aplica a los archivos con contenido binario en Google Drive. Se pueden conservar un máximo de 200 revisiones por archivo. Si se alcanza el límite, debes eliminar las revisiones que ya tengas para añadir otras. El valor predeterminado es false.
`OCRLanguage`	Cadena	No	Este campo proporciona una sugerencia de idioma para el OCR (reconocimiento óptico de caracteres) al importar archivos de imagen. Especifique el idioma mediante un código de idioma de dos letras ISO 639-1, como `en` para inglés o `de` para alemán.
`SupportsAllDrives`	Booleano	Sí	Este parámetro indica si se deben registrar los cambios en Mi unidad y en las unidades compartidas. Asigna el valor true a este parámetro para habilitar el acceso a las unidades compartidas. El valor predeterminado es false.

Parámetros de salida

Nombre del parámetro	Tipo de datos	Descripción
`CopiedFileID`	Cadena	ID del archivo copiado.
`Success`	Cadena	Este parámetro indica si la operación se ha realizado correctamente o no.

Ejemplo de caso práctico

En el siguiente ejemplo se muestra cómo configurar la acción CopyResource en Application Integration:

En el cuadro de diálogo Configurar tarea de conector, haga clic en Acciones.
Seleccione la acción CopyResource y, a continuación, haga clic en Hecho.
En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "NewName": "Copied of Untitles Document.txt1750848165952", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
      
```
Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
        [{"CopiedFileID": "15NUzJGarp-b8TdT0tXBGD9hJMnYjZbiydaE4lbZV0EU", "Success": "TRUE"}]
      
```

CreateFolder

Descripción: crea una carpeta en Google Drive. Debes asignar un nombre a la nueva carpeta y especificar su ubicación proporcionando los IDs de sus carpetas principales. También puedes añadir una descripción opcional y marcar la carpeta como destacada.

Parámetros de entrada

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
`Name`	Cadena	Sí	Título de la carpeta.
`Description`	Cadena	No	La descripción de la carpeta.
`Starred`	Booleano	No	Este parámetro indica si la carpeta está marcada con una estrella. El valor predeterminado es false.
`ParentIds`	Cadena	Sí	Lista de IDs de las carpetas principales en las que se creará la nueva carpeta, separados por comas.

Parámetros de salida

Nombre del parámetro	Tipo de datos	Descripción
`Success`	Cadena	Este parámetro indica si la operación se ha realizado correctamente o no.
`Id`	Cadena	ID de la nueva carpeta.

Ejemplo de caso práctico

En el siguiente ejemplo se muestra cómo configurar la acción CreateFolder en Application Integration:

En el cuadro de diálogo Configurar tarea de conector, haga clic en Acciones.
Seleccione la acción CreateFolder y, a continuación, haga clic en Hecho.
En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:
```
        { "Name": "Test Folder", "ParentIds": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
      
```
Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
        [{"Success": "TRUE", "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}]
      
```

DeleteResource

Descripción: elimina de forma permanente un archivo o una carpeta de Google Drive. Para usar esta acción, debes proporcionar el ID único del recurso que quieras eliminar.

Parámetros de entrada

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
`Id`	Cadena	Sí	ID del recurso que se va a eliminar.

Parámetros de salida

Nombre del parámetro	Tipo de datos	Descripción
`Success`	Cadena	Este parámetro indica si la operación se ha realizado correctamente o no.

Ejemplo de caso práctico

En el siguiente ejemplo se muestra cómo configurar la acción DeleteResource en Application Integration:

En el cuadro de diálogo Configurar tarea de conector, haga clic en Acciones.
Seleccione la acción DeleteResource y, a continuación, haga clic en Hecho.
En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c"}
      
```
Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
        [{"Success": "TRUE"}]
      
```

DownloadFile

Descripción: descarga un archivo de Google Drive.

Parámetros de entrada

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
`Id`	Cadena	Sí	ID del archivo que se va a descargar.
`LocalFile`	Cadena	No	La ruta y el nombre del archivo donde se guardará. Déjelo vacío para almacenar el archivo en la memoria.
`Encoding`	Cadena	No	Tipo de codificación de los datos del archivo. Si LocalFile está vacío, los datos del archivo se devolverán con la codificación especificada. Los valores permitidos son NONE y BASE64. El valor predeterminado es BASE64.
`Overwrite`	Booleano	No	Este parámetro determina si se debe sobrescribir el archivo si ya existe al descargarlo. El valor predeterminado es "false". Defina el parámetro como "TRUE" para sobrescribir el archivo.
`FileFormat`	Cadena	No	El formato en el que se puede descargar el archivo. El tamaño máximo del archivo es de 10 MB. Deja este parámetro en blanco para descargar el archivo en su formato original. Los formatos admitidos son DOCX, ODT, RTF, HTML, TXT y PDF.

Parámetros de salida

Nombre del parámetro	Tipo de datos	Descripción
`FileData`	Cadena	Si no se proporciona LocalFile, los datos del archivo se devolverán con la codificación especificada.
`Success`	Cadena	Este parámetro indica si la operación se ha realizado correctamente o no.

Ejemplo de caso práctico

En el siguiente ejemplo se muestra cómo configurar la acción DownloadFile en Application Integration:

En el cuadro de diálogo Configurar tarea de conector, haga clic en Acciones.
Seleccione la acción DownloadFile y, a continuación, haga clic en Hecho.
En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "LocalFile": "gs://test-bucket/test-file.txt", "Encoding": "NONE", "Overwrite": true, "FileFormat": "HTML"}
      
```
Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
        [{"FileData": "This is a test file.", "Success": "TRUE"}]
      
```

MoveResource

Descripción: mueve un archivo o una carpeta a otra ubicación de Google Drive. Debe proporcionar el ID del recurso que se va a mover y los IDs de las nuevas carpetas principales.

Parámetros de entrada

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
`Id`	Cadena	Sí	ID del recurso que se va a mover.
`ParentIDs`	Cadena	Sí	Lista de IDs separados por comas que se usarán como carpetas principales. Un recurso de una unidad compartida debe tener exactamente una carpeta principal, y solo los usuarios con el rol "Organizador de archivos" u "Organizador" pueden mover archivos y carpetas dentro de una unidad compartida.

Parámetros de salida

Nombre del parámetro	Tipo de datos	Descripción
`Success`	Cadena	Este parámetro indica si la operación se ha realizado correctamente o no.

Ejemplo de caso práctico

En el siguiente ejemplo se muestra cómo configurar la acción MoveResource en Application Integration:

En el cuadro de diálogo Configurar tarea de conector, haga clic en Acciones.
Seleccione la acción MoveResource y, a continuación, haga clic en Hecho.
En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5"}
      
```
Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
        [{"Success": "TRUE"}]
      
```

UpdateResource

Descripción: actualiza los metadatos de un archivo o una carpeta de Google Drive. Puedes modificar su nombre, descripción, tipo MIME y si está destacada.

Parámetros de entrada

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
`Id`	Cadena	Sí	ID del recurso que se va a actualizar.
`Name`	Cadena	Sí	El nuevo nombre del archivo actualizado.
`Description`	Cadena	No	Una descripción del archivo o la carpeta.
`MIMEType`	Cadena	No	Tipo MIME del archivo.
`Starred`	Cadena	No	Este parámetro indica si el recurso está destacado. El valor predeterminado es false.

Parámetros de salida

Nombre del parámetro	Tipo de datos	Descripción
`Success`	Cadena	Este parámetro indica si la operación se ha realizado correctamente o no.

Ejemplo de caso práctico

En el siguiente ejemplo se muestra cómo configurar la acción UpdateResource en Application Integration:

En el cuadro de diálogo Configurar tarea de conector, haga clic en Acciones.
Seleccione la acción UpdateResource y, a continuación, haga clic en Hecho.
En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "Name": "New Name", "Description": "New Description", "MIMEType": "application/vnd.google-apps.document", "Starred": true}
      
```
Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
        [{"Success": "TRUE"}]
      
```

UploadFile

Descripción: sube un archivo a Google Drive. Debe proporcionar los datos del archivo y su tipo MIME. También puedes especificar la carpeta principal en la que se colocará el archivo y el nombre del archivo subido.

Parámetros de entrada

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
`Id`	Cadena	Sí	ID del archivo que se va a subir.
`FileData`	Cadena	Sí	Los datos del archivo que se va a subir.
`MIMEType`	Cadena	Sí	Tipo MIME del archivo.
`ParentIDs`	Cadena	No	Lista de IDs de carpetas principales separadas por comas en las que se colocará el archivo subido. Si no se especifica, el archivo se subirá a la carpeta raíz de Mi unidad del usuario.
`Filename`	Cadena	No	Nombre del archivo que se va a subir.

Parámetros de salida

Nombre del parámetro	Tipo de datos	Descripción
`Success`	Cadena	Este parámetro indica si la operación se ha realizado correctamente o no.

Ejemplo de caso práctico

En el siguiente ejemplo se muestra cómo configurar la acción UploadFile en Application Integration:

En el cuadro de diálogo Configurar tarea de conector, haga clic en Acciones.
Seleccione la acción UploadFile y, a continuación, haga clic en Hecho.
En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:
```
        { "Id": "10QIXnPK3DjiLnVL1QvpIsuHPo16zVkYQuJsTVvt_B-c", "FileData": "This is a test file.", "MIMEType": "text/plain", "ParentIDs": "1uaAUsRZLLF07KypCDNUBvHn3Xx2lxmo5", "Filename": "test-file.txt"}
      
```
Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:
```
        [{"Success": "TRUE"}]
      
```

SubscribeToFileChanges

Descripción: se suscribe a las notificaciones de los cambios realizados en un archivo específico de Google Drive.

Parámetros de entrada

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
`Id`	Cadena	Sí	ID del archivo al que se va a suscribir.
`Token`	Cadena	Sí	El token que se usará para suscribirse a los cambios de archivo.

Parámetros de salida

Nombre del parámetro	Tipo de datos	Descripción
`Success`	Cadena	Este parámetro indica si la operación se ha realizado correctamente o no.

Ejemplo de caso práctico

En el siguiente ejemplo se muestra cómo configurar la acción SubscribeToFileChanges en Application Integration:

En el cuadro de diálogo Configurar tarea de conector, haga clic en Acciones.
Seleccione la acción SubscribeToFileChanges y, a continuación, haga clic en Hecho.

En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

        {
          "FileId": "1o-SMcimUT91sfLNf6NoESirH9BsVqvym0YORLo2GAoY",
          "Id": "Id11752060129918",
          "Address": "https://cloudsearch.googleapis.net/notifications",
          "ChannelToken": "token"
        }

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

        [
          {
            "Kind": "api#channel",
            "Id": "Id11752060129918",
            "ResourceId": "BfrGPBKDiD1SH1dg6Ng73nLTfl0",
            "ResourceUri": "https://www.googleapis.com/drive/v3/files/1o-SMcimUT91sfLNf6NoESirH9BsVqvym0YORLo2GAoY?alt=json&supportsAllDrives=true",
            "Token": "token",
            "Expiration": "1752063731000"
          }
        ]

SubscribeToUserChanges

Descripción: se suscribe a las notificaciones de los cambios realizados por un usuario específico en Google Drive.

Parámetros de entrada

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
`Id`	Cadena	Sí	El ID del usuario al que se va a suscribir.
`Token`	Cadena	Sí	Token que se usará para suscribirse a los cambios de usuario.

Ejemplo de caso práctico

En el siguiente ejemplo se muestra cómo configurar la acción SubscribeToUserChanges en Application Integration:

En el cuadro de diálogo Configurar tarea de conector, haga clic en Acciones.
Seleccione la acción SubscribeToUserChanges y, a continuación, haga clic en Hecho.

En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

        {
          "Id": "11752060129918",
          "Address": "https://cloudsearch.googleapis.net/notifications",
          "ChannelToken": "token"
        }

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

        [
          {
            "Kind": "api#channel",
            "Id": "Id11752060129918",
            "ResourceId": "BfrGPBKDiD1SH1dg6Ng73nLTfl0",
            "ResourceUri": "https://www.googleapis.com/drive/v3/users/me?alt=json&supportsAllDrives=true",
            "Token": "token",
            "Expiration": "1752063731000"
          }
        ]

StopWatchingResources

Descripción: te da de baja para que no recibas notificaciones de un recurso que hayas visto anteriormente.

Parámetros de entrada

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
`Id`	Cadena	Sí	El ID del recurso que se va a dejar de observar.
`Token`	Cadena	Sí	Token que se usará para dejar de monitorizar recursos.

Ejemplo de caso práctico

En el siguiente ejemplo se muestra cómo configurar la acción StopWatchingResources en Application Integration:

En el cuadro de diálogo Configurar tarea de conector, haga clic en Acciones.
Seleccione la acción StopWatchingResources y, a continuación, haga clic en Hecho.

En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

        {
          "Id": "Id11752060129918",
          "Token": "token"
        }

Si la acción se realiza correctamente, el parámetro de respuesta connectorOutputPayload de la tarea del conector tendrá un valor similar al siguiente:

        [
          {
            "Kind": "api#channel",
            "Id": "stopid1751971586168",
            "ResourceId": "CXPNGzAnYjqSazkd9-nNTFHTkwo",
            "ResourceUri": "https://www.googleapis.com/drive/v3/files/11OsOCgkV5hsRai6UwpkLngvqnCcrA4sy1tqfPi_VJio?alt=json&supportsAllDrives=true",
            "Token": null,
            "Expiration": "1751975186000"
          }
        ]

Limitaciones del sistema

El conector de Google Drive puede procesar un máximo de 2 QPS por segundo por nodo y limita las transacciones que superen este límite. De forma predeterminada, Integration Connectors asigna 2 nodos (para mejorar la disponibilidad) a una conexión.

Para obtener información sobre los límites aplicables a Integration Connectors, consulta Límites.

Nota: El número de nodos de Integration Connectors se ajustará automáticamente de forma dinámica en función de tu uso. Sin embargo, si quieres reservar capacidad para grandes volúmenes sin esperar al autoescalado, puedes ajustar el valor mínimo de nodos de una conexión. Se necesitan más nodos para procesar más transacciones de una conexión. Por el contrario, se necesitan menos nodos si una conexión procesa menos transacciones. Para configurar los valores del nodo, haz lo siguiente:

Si eres cliente de pago por uso, configura el valor mínimo y máximo del nodo en la página de edición de la conexión.
Si tienes una suscripción, ponte en contacto con el equipo de Asistencia.

El número máximo de transacciones que puede gestionar un nodo depende de varios factores. Por lo tanto, antes de ajustar el número mínimo de nodos para mejorar el rendimiento, le recomendamos que compruebe si sus sistemas backend están configurados de forma óptima para gestionar el tráfico necesario.

Siguientes pasos

Consulta cómo crear y configurar una conexión de Google Drive.
Consulta cómo suspender y reactivar una conexión.
Consulta cómo monitorizar el uso de los conectores.
Consulta cómo ver los registros de conectores.

Obtener ayuda de la comunidad de Google Cloud

Puedes publicar tus preguntas y hablar sobre este conector en la comunidad de Google Cloud, en los foros de Cloud.