Se usó la API de Cloud Translation para traducir esta página.

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 obtener la lista de entidades y operaciones compatibles, consulta Entidades y operaciones compatibles. Para obtener información sobre las acciones específicas del conector compatibles, consulta Acciones compatibles.

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 de Google Drive v3.
Google Drive v2: Usa esta versión del conector para acceder a la API de Google Drive v2.

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

Operaciones y entidades compatibles

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`, `Delete`
`Folder`	Representa una carpeta en Google Drive.	`Get`, `List`, `Create`, `Update`, `Delete`
`Permission`	Representa un permiso para un archivo o una carpeta en Google Drive.	`Get`, `List`, `Create`, `Update`, `Delete`
`Drive`	Representa una unidad en Google Drive.	`Get`, `List`, `Create`, `Update`, `Delete`

Para ver ejemplos de casos de uso de Application Integration, consulta Ejemplos de casos de uso en 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 nombre nuevo 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`	String	Sí	ID del recurso que se copiará.
`NewName`	String	Sí	Es el nuevo nombre del archivo copiado.
`ParentIDs`	String	No	Es una lista separada por comas de los IDs de las carpetas principales en las 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 omitirá la configuración de visibilidad predeterminada para el archivo recién creado. Si el dominio está configurado para que todos los archivos subidos sean visibles de forma predeterminada, establecer este parámetro como verdadero anula ese comportamiento para esta solicitud específica. El valor predeterminado es falso.
`IncludeLabels`	String	No	Es una lista separada por comas de los IDs de las etiquetas que se incluirán en la parte labelInfo de la respuesta.
`IncludePermissionsForView`	String	Sí	Este campo especifica qué permisos de vista adicionales se deben incluir en la respuesta. Se publicó el valor admitido.
`KeepRevisionForever`	Booleano	No	Indica si se deben conservar las revisiones del archivo de forma indefinida. Esta función solo se aplica a los archivos con contenido binario en Google Drive. Se puede conservar un máximo de 200 revisiones por archivo de forma indefinida. Si se alcanza el límite, debes borrar las revisiones existentes para agregar otras nuevas. El valor predeterminado es falso.
`OCRLanguage`	String	No	Este campo proporciona una sugerencia de idioma para el OCR (reconocimiento óptico de caracteres) cuando se importan archivos de imagen. Especifica el idioma con un código de idioma ISO 639-1 de dos letras, como `en` para inglés o `de` para alemán.
`SupportsAllDrives`	Booleano	Sí	Este parámetro indica si se deben hacer un seguimiento de los cambios en Mi unidad y las unidades compartidas. Establece este parámetro en verdadero para habilitar el acceso a las unidades compartidas. El valor predeterminado es falso.

Los parámetros de resultado

Nombre del parámetro	Tipo de dato	Descripción
`CopiedFileID`	String	ID del archivo copiado.
`Success`	String	Este parámetro indica si la operación se realizó correctamente o no.

Ejemplo de caso de uso

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, haz clic en Acciones.
Selecciona la acción CopyResource y haz clic en Listo.

En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa 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 nueva en tu unidad de Google Drive. Debes proporcionar un nombre para la carpeta nueva y especificar su ubicación con los IDs de sus carpetas principales. También puedes agregar 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`	String	Sí	Es el título de la carpeta.
`Description`	String	No	Es la descripción de la carpeta.
`Starred`	Booleano	No	Este parámetro indica si la carpeta está destacada. El valor predeterminado es falso.
`ParentIds`	String	Sí	Es una lista separada por comas de los IDs de las carpetas principales en las que se creará la carpeta nueva.

Los parámetros de resultado

Nombre del parámetro	Tipo de dato	Descripción
`Success`	String	Este parámetro indica si la operación se realizó correctamente o no.
`Id`	String	Es el ID de la carpeta nueva.

Ejemplo de caso de uso

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, haz clic en Acciones.
Selecciona la acción CreateFolder y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa 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: Quita de forma permanente un archivo o una carpeta de Google Drive. Para usar esta acción, debes proporcionar el ID único del recurso que deseas borrar.

Parámetros de entrada

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
`Id`	String	Sí	Es el ID del recurso que se borrará.

Los parámetros de resultado

Nombre del parámetro	Tipo de dato	Descripción
`Success`	String	Este parámetro indica si la operación se realizó correctamente o no.

Ejemplo de caso de uso

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, haz clic en Acciones.
Selecciona la acción DeleteResource y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa 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`	String	Sí	ID del archivo que se descargará.
`LocalFile`	String	No	Ruta de acceso y nombre del archivo en el que se guardará. Déjalo vacío para almacenar el archivo en la memoria.
`Encoding`	String	No	Es el tipo de codificación de los datos del archivo. Si LocalFile está vacío, los datos del archivo se devolverán en 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 reemplazará el archivo si ya existe cuando se descarga. El valor predeterminado es falso. Establece el parámetro en TRUE para reemplazar el archivo.
`FileFormat`	String	No	Es el formato en el que se puede descargar el archivo. El tamaño máximo del archivo puede ser de 10 MB. Deja este parámetro en blanco para descargar el archivo en su formato original. Los formatos compatibles son DOCX, ODT, RTF, HTML, TXT y PDF.

Los parámetros de resultado

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

Ejemplo de caso de uso

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, haz clic en Acciones.
Selecciona la acción DownloadFile y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa 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 una ubicación diferente dentro de Google Drive. Debes proporcionar el ID del recurso que se moverá y los IDs de las nuevas carpetas principales.

Parámetros de entrada

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
`Id`	String	Sí	ID del recurso que se moverá.
`ParentIDs`	String	Sí	Es una lista de IDs separados por comas que se usarán como carpetas principales. Un recurso dentro de una unidad compartida debe tener exactamente una carpeta superior, y solo los usuarios con el rol de "organizador de archivos" o "organizador" pueden mover archivos y carpetas dentro de una unidad compartida.

Los parámetros de resultado

Nombre del parámetro	Tipo de dato	Descripción
`Success`	String	Este parámetro indica si la operación se realizó correctamente o no.

Ejemplo de caso de uso

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, haz clic en Acciones.
Selecciona la acción MoveResource y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa 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 en Google Drive. Puedes modificar su nombre, descripción, tipo de MIME y si está destacado.

Parámetros de entrada

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

Los parámetros de resultado

Nombre del parámetro	Tipo de dato	Descripción
`Success`	String	Este parámetro indica si la operación se realizó correctamente o no.

Ejemplo de caso de uso

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, haz clic en Acciones.
Selecciona la acción UpdateResource y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa 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. Debes proporcionar los datos del archivo y su tipo de MIME. También puedes especificar la carpeta principal en la que se colocará el archivo y un nombre para el archivo subido.

Parámetros de entrada

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
`Id`	String	Sí	ID del archivo que se subirá.
`FileData`	String	Sí	Son los datos del archivo que se subirán.
`MIMEType`	String	Sí	Tipo de MIME del archivo.
`ParentIDs`	String	No	Es una lista separada por comas de los IDs de las carpetas principales 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`	String	No	Nombre del archivo que se subirá.

Los parámetros de resultado

Nombre del parámetro	Tipo de dato	Descripción
`Success`	String	Este parámetro indica si la operación se realizó correctamente o no.

Ejemplo de caso de uso

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, haz clic en Acciones.
Selecciona la acción UploadFile y haz clic en Listo.
En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa 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 cambios en un archivo específico de Google Drive.

Parámetros de entrada

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

Los parámetros de resultado

Nombre del parámetro	Tipo de dato	Descripción
`Success`	String	Este parámetro indica si la operación se realizó correctamente o no.

Ejemplo de caso de uso

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, haz clic en Acciones.
Selecciona la acción SubscribeToFileChanges y haz clic en Listo.

En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa 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 que realiza un usuario específico en Google Drive.

Parámetros de entrada

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

Ejemplo de caso de uso

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, haz clic en Acciones.
Selecciona la acción SubscribeToUserChanges y haz clic en Listo.

En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa 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: Anula tu suscripción para dejar de recibir notificaciones sobre un recurso que viste anteriormente.

Parámetros de entrada

Nombre del parámetro	Tipo de datos	Obligatorio	Descripción
`Id`	String	Sí	ID del recurso cuya supervisión se detendrá.
`Token`	String	Sí	Es el token que se usará para dejar de mirar recursos.

Ejemplo de caso de uso

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, haz clic en Acciones.
Selecciona la acción StopWatchingResources y haz clic en Listo.

En la sección Task Input de la tarea Connectors, haz clic en connectorInputPayload y, luego, ingresa 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 transacciones por segundo (TPS), por nodo, y limita las transacciones que superen este límite. De forma predeterminada, Integration Connectors asigna 2 nodos (para una mejor disponibilidad) a una conexión.

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

Nota: La cantidad de nodos de Integration Connectors se ajustará automáticamente según tu uso. Sin embargo, si deseas reservar capacidad para grandes volúmenes sin esperar el ajuste de escala automático, puedes ajustar el valor mínimo de nodos para una conexión. Se requieren más nodos para procesar más transacciones para una conexión. Por el contrario, se requieren 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 eres cliente de un plan de suscripción, comunícate con el equipo de asistencia.

La cantidad máxima de transacciones que puede procesar un nodo depende de varios factores. Por lo tanto, antes de ajustar la cantidad mínima de nodos para mejorar el rendimiento, te recomendamos que verifiques si tus sistemas de backend están configurados de manera óptima para controlar el tráfico requerido.

¿Qué sigue?

Obtén información para crear y configurar una conexión de Google Drive.
Obtén información para suspender y reanudar una conexión.
Obtén información para supervisar el uso del conector.
Comprende cómo ver los registros del conector.

Obtén ayuda de la Comunidad de Google Cloud

Puedes publicar tus preguntas y debatir sobre este conector en la comunidad de Google Cloud en Cloud Forums.