Dropbox

El conector de Dropbox te permite conectarte a una instancia de Dropbox y realizar las operaciones compatibles.

Antes de comenzar

Antes de usar el conector de Dropbox, realiza las siguientes tareas:

  • En tu proyecto de Google Cloud, haz lo siguiente:
    • Otorga el rol de IAM roles/connectors.admin al usuario que configure el conector.
    • Otorga los siguientes roles de IAM a la cuenta de servicio que deseas usar para el conector:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Una cuenta de servicio es un tipo de Cuenta de Google especial que representa a un usuario no humano que debe autenticarse y tener autorización para acceder a los datos de las APIs de Google. Si no tienes una cuenta de servicio, debes crear una. Para obtener más información, consulta Crea una cuenta de servicio.

    • Habilita los siguientes servicios:
      • secretmanager.googleapis.com (API de Secret Manager)
      • connectors.googleapis.com (API de conectores)

      Para comprender cómo habilitar servicios, consulta Habilita servicios.

    Si estos servicios o permisos no se habilitaron antes para tu proyecto, se te solicitará que los habilites cuando configures el conector.

Configura el conector

Para configurar el conector, debes crear una conexión a tu fuente de datos (sistema de backend). Una conexión es específica de una fuente de datos. Significa que, si tienes muchas fuentes de datos, debes crear una conexión independiente para cada fuente. Para crear una conexión, sigue estos pasos:

  1. En la consola de Cloud, ve a la página Conectores de Integration > Conexiones y, luego, selecciona o crea un proyecto de Google Cloud.

    Ir a la página Conexiones

  2. Haz clic en + Crear nuevo para abrir la página Crear conexión.
  3. En la sección Ubicación, elige la ubicación para la conexión.
    1. Región: selecciona una ubicación de la lista desplegable.

      Para obtener la lista de todas las regiones compatibles, consulta Ubicaciones.

    2. Haz clic en SIGUIENTE.
  4. En la sección Detalles de la conexión, completa lo siguiente:
    1. Conector: Selecciona Dropbox en la lista desplegable de conectores disponibles.
    2. Versión del conector: selecciona la versión del conector de la lista desplegable de versiones disponibles.
    3. En el campo Nombre de la conexión, ingresa un nombre para la instancia de conexión.

      Los nombres de las conexiones deben cumplir con los siguientes criterios:

      • Los nombres de las conexiones pueden usar letras, números o guiones.
      • Las letras deben estar en minúsculas.
      • Los nombres de las conexiones deben comenzar con una letra y terminar con una letra o un número.
      • Los nombres de conexión no pueden superar los 49 caracteres.
    4. De manera opcional, ingresa una Descripción para la instancia de conexión.
    5. Cuenta de servicio: Selecciona una cuenta de servicio que tenga los roles necesarios.
    6. De manera opcional, configura los parámetros de nodo de conexión:

      • Cantidad mínima de nodos: Ingresa la cantidad mínima de nodos de conexión.
      • Cantidad máxima de nodos: Ingresa la cantidad máxima de nodos de conexión.

      Un nodo es una unidad (o réplica) de una conexión que procesa transacciones. Se requieren más nodos para procesar más transacciones para una conexión y, del mismo modo, se requieren menos para procesar menos transacciones. Para comprender cómo los nodos afectan el precio del conector, consulta Precios de nodos de conexión. Si no ingresas ningún valor, se establecen de forma predeterminada los nodos mínimos en 2 (para una mejor disponibilidad) y los nodos máximos se establecen en 50.

    7. ID de usuario para actuar en su nombre: Especifica el ID de usuario para actuar en su nombre (opcional).
    8. Suplantación de identidad del usuario:Opcional para especificar el tipo de suplantación del usuario. Debería ser el modo de Usuario o Administrador.
    9. Incluir subdirectorios: Opcional si deseas incluir subdirectorios mientras enumeras archivos y carpetas.
    10. Incluye recursos del equipo:Opcionalmente, si deseas incluir archivos y carpetas del equipo.
    11. De forma opcional, haz clic en + Agregar etiqueta para agregar una etiqueta a la conexión en forma de un par clave-valor.
    12. Haz clic en Siguiente.
  5. En la sección Autenticación, ingresa los detalles de autenticación.
    1. Selecciona un Tipo de autenticación y, luego, ingresa los detalles relevantes.

      La conexión de Dropbox admite los siguientes tipos de autenticación:

      • Otorgamiento de código de autenticación de OAuth 2.0

      2. Para comprender cómo configurar estos tipos de autenticación, consulta Configura la autenticación.

    2. Haz clic en Siguiente.
  6. Revisa: Revisa tus detalles de conexión y autenticación.
  7. Haz clic en Crear.

Configura la autenticación

Ingresa los detalles según la autenticación que desees usar.

  • Otorgamiento de código de autorización de OAuth 2.0
    • ID de cliente: el ID de cliente que se usa para solicitar tokens de acceso.
    • Alcances: Una lista separada por comas de los permisos deseados del portal de permisos del buzón.
    • Secreto de cliente: el secreto del cliente que se usa para solicitar tokens de acceso.

Entidades, operaciones y acciones

Todos los Integration Connectors proporcionan una capa de abstracción para los objetos de la aplicación conectada. Solo puedes acceder a los objetos de una aplicación a través de esta abstracción. La abstracción se expone como entidades, operaciones y acciones.

  • Entidades: Una entidad puede considerarse como un objeto o una colección de propiedades en la aplicación o servicio conectados. La definición de una entidad difiere de conector a conector. Por ejemplo, en un conector de bases de datos, las tablas son las entidades; en un conector de servidor de archivos, las carpetas son las entidades; en un conector de sistema de mensajería, las colas son las entidades.

    Sin embargo, es posible que un conector no admita o tenga ninguna entidad, en cuyo caso la lista Entities estará vacía.

  • Operaciones: Una operación es la actividad que puedes realizar en una entidad. Puedes realizar cualquiera de las siguientes operaciones en una entidad:

    Cuando se selecciona una entidad de la lista disponible, se genera una lista de operaciones disponibles para esa entidad. Para obtener una descripción detallada de las operaciones, consulta las operaciones de entidades de la tarea de conectores. Sin embargo, si un conector no admite ninguna de las operaciones de entidad, estas operaciones no compatibles no se incluyen en la lista Operations.

  • Acción: Una acción es una función de primera clase que está disponible para la integración mediante la interfaz de Conectores. Una acción te permite realizar cambios en una entidad o entidades y variar de un conector a otro. Normalmente, una acción tendrá algunos parámetros de entrada y una parámetro. Sin embargo, es posible que un conector no admita ninguna acción, en cuyo caso la lista Actions estará vacía.

Limitaciones del sistema

El conector de Dropbox puede procesar 18 transacciones por segundo por nodo y limita las transacciones que superen este límite. De forma predeterminada, Integration Connectors asigna 2 nodos (para una mejor disponibilidad) por una conexión.

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

Acciones

En esta sección, se enumeran las acciones que admite el conector. Para comprender cómo configurar las acciones, consulta Ejemplos de acciones.

Acción CopyResource

Esta acción te permite copiar un archivo o una carpeta a una ubicación diferente en el Dropbox del usuario.

Parámetros de entrada de la acción CopyResource

Nombre del parámetro Tipo de datos Obligatorio Descripción
From_Path String Sí Es la ruta de acceso en el Dropbox del usuario que se copiará o moverá.
To_Path String Sí Es la ruta de destino en el Dropbox del usuario para el recurso copiado.
Renombrar automáticamente String No Si hay un conflicto, pídele al servidor de Dropbox que intente cambiar automáticamente el nombre del archivo para evitarlo. El valor predeterminado para este campo es "Falso".
Allow_Ownership_Transfer String No Permitir que el propietario realice traslados, incluso si se produce una transferencia de propiedad del contenido que se traslada Esto no se aplica a las copias. El valor predeterminado de este campo es Falso.
ObjectPathsAggregate String No Un agregado que representa la ruta del objeto. También puede ser el nombre de una tabla #TEMP.

Por ejemplo, sobre cómo configurar la acción CopyResource, consulta Ejemplos de acciones.

Acción CreateFolder

Esta acción te permite crear una carpeta en una ruta de acceso determinada.

Parámetros de entrada de la acción CreateFolder

Nombre del parámetro Tipo de datos Obligatorio Descripción
Ruta String Sí Es la ruta de acceso en el Dropbox del usuario que se creará.
AutoRename Booleano No Si hay un conflicto, haz que el servidor de Dropbox intente cambiar el nombre de la carpeta de forma automática para evitarlo. El valor predeterminado es falso.
ForceAsync Booleano No Establece si se forzará la creación para que ocurra de forma asíncrona. Solo está disponible cuando se usa ObjectPathsAggregate. El valor predeterminado es falso.
ObjectPathsAggregate String No Un agregado JSON que representa las rutas. También puede ser el nombre de una tabla #TEMP.

Para ver ejemplos sobre cómo configurar la acción CreateFolder, consulta Ejemplos de acciones.

Acción DeleteResource

Esta acción te permite borrar el archivo o la carpeta en una ruta determinada. Si la ruta de acceso es una carpeta, también se borrará todo su contenido.

Parámetros de entrada de la acción DeleteResource

Nombre del parámetro Tipo de datos Obligatorio Descripción
Ruta String Sí Es un identificador único para el archivo o la carpeta.
ObjectPathsAggregate String No Un agregado que representa la ruta del objeto. También puede ser el nombre de una tabla #TEMP.

Para ver ejemplos sobre cómo configurar la acción DeleteResource, consulta Ejemplos de acciones.

Acción MoveResource

Mover un archivo o una carpeta a una ubicación diferente en el Dropbox del usuario Si la ruta de acceso de origen es una carpeta, se moverá todo su contenido. Ten en cuenta que actualmente no admitimos el cambio de nombre de solo mayúsculas y minúsculas.

Parámetros de entrada de la acción MoveResource

Nombre del parámetro Tipo de datos Obligatorio Descripción
From_Path String Sí Es la ruta de acceso en el Dropbox del usuario que se copiará o moverá.
To_Path String Sí Es la ruta de Dropbox del usuario que es el destino.
Cambiar nombre automáticamente String No Si hay un conflicto, pídele al servidor de Dropbox que intente cambiar automáticamente el nombre del archivo para evitarlo. El valor predeterminado para este campo es "Falso".
Allow_Ownership_Transfer String No Permitir que el propietario realice traslados, incluso si se produce una transferencia de propiedad del contenido que se traslada Esto no se aplica a las copias. El valor predeterminado de este campo es Falso.
ObjectPathsAggregate String No Un agregado que representa la ruta del objeto. También puede ser el nombre de una tabla #TEMP.

Por ejemplo, sobre cómo configurar la acción MoveResource, consulta Ejemplos de acciones.

Acción RenameResource

Esta acción te permite cambiar el nombre de un recurso proporcionando una ruta y un nombre nuevo.

Parámetros de entrada de la acción RenameResource

Nombre del parámetro Tipo de datos Obligatorio Descripción
Ruta String Sí Es la ruta de acceso al recurso cuyo nombre se cambiará. EJ.: /myFolder/sample.txt
NewName String Sí Es el nombre nuevo del recurso. P. ej.: sampleDocument.txt

Por ejemplo, sobre cómo configurar la acción RenameResource, consulta Ejemplos de acciones.

Acción para dejar de compartir la carpeta

Esta acción te permite dejar de compartir una carpeta. Requiere el alcance de sharing.write.

Parámetros de entrada de la acción UnshareFolder

Nombre del parámetro Tipo de datos Obligatorio Descripción
FolderId String Sí El ID de la carpeta compartida que se dejará de compartir.
LeaveCopy String No Si es verdadero, los miembros de esta carpeta compartida recibirán una copia de la carpeta cuando se deje de compartir. El valor predeterminado es falso.

Para ver ejemplos sobre cómo configurar la acción UnshareFolder, consulta Ejemplos de acciones.

Acción DownloadFile

Esta acción te permite descargar un archivo. Requiere el alcance de files.content.read.

Parámetros de entrada de la acción DownloadFile

Nombre del parámetro Tipo de datos Obligatorio Descripción
ID String Sí Es el ID del documento que se descargará.
Revisión String No Es la revisión del documento que se descargará, por ejemplo, "rev:a1c10ce0dd78".
Ruta String No Es la ruta del archivo o la carpeta que se descargará.
AsZip Booleano No Descargar una carpeta en formato ZIP Debe establecerse en "true" para descargar una carpeta.
FileStream String No Una instancia de una transmisión de salida en la que se escriben los datos del archivo. Solo se utiliza si DownloadTo no está configurado.
DownloadTo String No Es la ruta de la carpeta a la que se descargará el archivo.
FileType String Sí El tipo de archivo(archivo o papel)

Para ver ejemplos sobre cómo configurar la acción DownloadFile, consulta Ejemplos de acciones.

Ejemplos de acciones

En esta sección, se describe cómo realizar algunas de las acciones en este conector.

Ejemplo: Cómo copiar un recurso

En el siguiente ejemplo, se muestra cómo copiar un recurso con una ruta específica en una ruta diferente:

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Selecciona la acción CopyResource y haz clic en Listo.
  3. 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: 
    {
  "From_Path": "/DropboxFolder/pptxFile.pptx",
  "To_Path": "/DropBoxFolder2/Folder/pptFile.pptx"
}

    4. Si la acción tiene éxito, el Respuesta connectorOutputPayload de la tarea CopyResource tendrá un valor similar al siguiente:

    [ { "Success": "true", "metadata_.tag": "file", 
  "metadata_name": "pptxFile.pptx", 
  "metadata_path_lower": "/testingdropboxupdated/abcde/pptxfile.pptx", 
  "metadata_path_display": "/TestingDropBoxUpdated/abcde/pptxFile.pptx", 
  "metadata_parent_shared_folder_id": "3204685267", "metadata_id": "id:8-07A6kHAoIAAAAAAAAC1w",
  "metadata_client_modified": "2024-06-13T11:06:37Z", "metadata_server_modified": "2024-07-12T10:19:02Z",
  "metadata_rev": "61d0a3560ecb5bf039dd3", "metadata_size": "17052", 
  "metadata_sharing_info_read_only": "false", "metadata_sharing_info_parent_shared_folder_id": "3204685267",
  "metadata_sharing_info_modified_by": "dbid:AACVLctlrEo-ouTSxUVSTi0loZCSZKc933A", 
  "metadata_is_downloadable": "true", 
  "metadata_content_hash": "0234f7d4eaf914cb276716c8b2a24e24655d1f6f39ee549207e33a4255e2fba2" } ]

Ejemplo: crea una carpeta

En el siguiente ejemplo, se muestra cómo crear una carpeta en una ruta de acceso determinada:

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Selecciona la acción CreateFolder y haz clic en Listo.
  3. 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: 
    {
  "Path": "/TestDrobBoxFolder/newFolder"
}

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

    [ { "Id": "id:8-07A6kHAoIAAAAAAAAC2Q" } ]

Ejemplo: Borra un recurso

En el siguiente ejemplo, se muestra cómo borrar un recurso:

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Selecciona la acción DeleteResource y haz clic en Listo.
  3. 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: 
    {
  "Path": "/TestingDropBox/FolderToBeDeletedName"
}

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

    [{
"Status": "Success"
}]

Ejemplo: Cómo mover un recurso

En el siguiente ejemplo, se muestra cómo mover un recurso:

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Selecciona la acción MoveResource y haz clic en Listo.
  3. 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: 
    {
  "From_Path": "/TestDropBoxFolder/Folder1/dummypdf2.pdf",
  "To_Path": "/EmptyFolder/Folder1/dummypdf2.pdf"
}

    4. Si la acción tiene éxito, el Respuesta connectorOutputPayload de la tarea MoveResource tendrá un valor similar al siguiente:

    [{
  "Status": "Success"
  }]

Ejemplo: Cambia el nombre de un recurso

En el siguiente ejemplo, se muestra cómo cambiar el nombre de un recurso:

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Selecciona la acción RenameResource y haz clic en Listo.
  3. 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: 
    {
  "Path": "/TestDropBox/abcd",
  "NewName": "abcded"
}

    4. Si la acción tiene éxito, el Respuesta connectorOutputPayload de la tarea RenameResource tendrá un valor similar al siguiente:

    [{
"Status": "Success"
}]

Ejemplo: Cómo dejar de compartir una carpeta

En el siguiente ejemplo, se muestra cómo dejar de compartir una carpeta:

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Selecciona la acción UnshareFolder y haz clic en Listo.
  3. 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: 
    {
  "FolderId": "3336772979"
}

    4. Si la acción tiene éxito, el Respuesta connectorOutputPayload de la tarea UnshareFolder tendrá un valor similar al siguiente:

    [{
"Status": "Success"
}]

Ejemplo: Cómo descargar un archivo

En el siguiente ejemplo, se muestra cómo descargar un archivo:

  1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
  2. Selecciona la acción DownloadFile y haz clic en Listo.
  3. 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": "id:8-07A6kHAoIAAAAAAAABcg",
  "FileType": "file"
}

    4. Si la acción tiene éxito, el Respuesta connectorOutputPayload de la tarea DownloadFile tendrá un valor similar al siguiente:

    [ { "Success": "true", "Name": "license.txt", 
  "Id": "id:8-07A6kHAoIAAAAAAAABcg", "ClientModified": "2024-07-09T09:52:41Z", 
  "ServerModified": "2024-07-09T09:52:41Z", "Revision": "61ccd7da2b987c0f52053", "Size": "11", 
  "LowerCasePath": "/sahil kapoor/testingdropboxupdated/uploadfolderwithnestedfolder/nestedfolder2/license.txt",
   "DisplayPath": "/Sahil Kapoor/TestingDropBoxUpdated/uploadFolderWithNestedFolder/NestedFolder2/license.txt",
    "PreviewURL": null, "IsDownloadable": "true", "HasExplicitSharedMembers": null, 
  "ContentHash": "f6dc724d119649460e47ce719139e521e082be8a9755c5bece181de046ee65fe", "Owner": null,
  "Title": null, "MimeType": null, "FileData": "SGVsbG8gd29ybGQ=", "parent_shared_folder_id": "3237290067",
  "sharing_info_read_only": "false", "sharing_info_parent_shared_folder_id": "3237290067", 
  "sharing_info_modified_by": "dbid:AACVLctlrEo-ouTSxUVSTi0loZCSZKc933A" } ]

Usa la conexión de Dropbox en una integración

Después de que crees la conexión, estará disponible en Apigee Integration y Application Integration. Puedes usar la conexión en una integración a través de la tarea Conectores.

  • Para comprender cómo crear y usar la tarea Connectors en la integración de Apigee, consulta Tarea Connectors.
  • Para comprender cómo crear y usar la tarea Connectors en la integración de aplicaciones, consulta Tarea Connectors.

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.

¿Qué sigue?