Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Documentos Google
Com o conector do Google Docs, é possível realizar as operações compatíveis no Google Docs.
Antes de começar
Antes de usar o conector do Google Docs, faça o seguinte:
No seu projeto do Google Cloud, faça o seguinte:
Verifique se a conectividade de rede está configurada. Para informações sobre padrões de rede, consulte Conectividade de rede.
Conceda o papel do IAM roles/connectors.admin ao usuário
que está configurando o conector.
Conceda os seguintes papéis de IAM à conta de serviço que você quer usar para o conector:
roles/secretmanager.viewer
roles/secretmanager.secretAccessor
Uma conta de serviço é um tipo especial de Conta do Google destinada a representar um usuário
não humano que precisa ser autenticado e autorizado a acessar dados nas APIs do Google.
Se você não tiver uma conta de serviço, será necessário criar uma. Para mais
informações, consulte
Como criar uma conta de serviço.
Se esses serviços ou permissões não tiverem sido ativados no seu projeto, você precisará ativá-los
ao configurar o conector.
Se você estiver usando a autenticação da conta de serviço em vez da autenticação do OAuth 2.0, verifique se as permissões adequadas foram concedidas à conta de serviço. Para mais informações, consulte Papéis e permissões do IAM.
Configurar o conector
Uma conexão é específica a uma fonte de dados. Isso
significa que, se você tiver muitas fontes de dados, precisará criar uma conexão separada
para cada uma. Para criar uma conexão, faça o seguinte:
No console do Cloud, acesse a página Integration Connectors > Conexões
e selecione ou crie um projeto do Google Cloud.
Clique em + Criar novo para abrir a página Criar conexão.
Na seção Local, escolha o local da conexão.
Região: selecione um local na lista suspensa.
Para conferir a lista de todas as regiões com suporte, consulte Locais.
Clique em Próxima.
Na seção Detalhes da conexão, defina os seguintes campos:
Conector: selecione Google Docs na lista suspensa de conectores disponíveis.
Versão do conector: selecione a versão do conector na lista suspensa de versões disponíveis.
No campo Nome da conexão, insira um nome para a instância de conexão.
Os nomes de conexão precisam atender aos seguintes critérios:
Os nomes de conexões podem usar letras, números ou hifens.
As letras precisam ser minúsculas.
Os nomes das conexões precisam começar com uma letra e terminar com uma letra ou um número.
Os nomes das conexões não podem exceder 49 caracteres.
Como opção, insira uma Descrição para a instância de conexão.
Se quiser registrar os detalhes da execução do conector, selecione Ativar o Cloud Logging.
Conta de serviço: selecione uma conta de serviço que tenha os papéis necessários.
Opcionalmente, defina as Configurações do nó de conexão:
Número mínimo de nós: digite o número mínimo de nós de conexão.
Número máximo de nós: digite o número máximo de nós de conexão.
Um nó é uma unidade (ou réplica) de uma conexão que processa transações.
Mais nós são necessários para processar mais transações para uma conexão e, por outro lado, menos nós são necessários para processar menos transações.
Para entender como os nós afetam os preços do conector, consulte
Preços dos nós de conexão. Se você não inserir qualquer valor, por padrão, os nós mínimos serão definidos como 2 (para melhor disponibilidade) e os nós máximos serão definidos como 50.
Outra opção é clicar em + Adicionar rótulo para adicionar um rótulo à conexão na forma de um par de chave-valor.
Clique em Próxima.
Na seção Autenticação, insira os detalhes da autenticação.
Selecione um Tipo de autenticação e insira os detalhes relevantes.
É possível escolher qualquer um dos seguintes tipos de autenticação:
Código de autorização OAuth 2.0 (gerenciado pelo Google)
Se você quiser que o Google Cloud gerencie o ID do cliente e a chave secreta do cliente em vez de você, selecione essa opção.
Código de autorização OAuth 2.0
Para entender como configurar esses tipos de autenticação, consulte Configurar autenticação.
Clique em Next.
Revisão: revise os detalhes de conexão e autenticação.
Clique em Criar.
Configurar a autenticação
Digite os detalhes com base na autenticação que você quer usar.
OAuth 2.0 - Código de autorização (gerenciado pelo Google)
Google Cloud gerencia o ID e a chave secreta do cliente, e você não precisa especificá-los.
Escopos: selecione os escopos necessários do OAuth 2.0 no menu suspenso. Para conferir todos os escopos do OAuth 2.0 compatíveis
para o Serviço do Google necessário, consulte a seção relevante
na página Escopos do OAuth 2.0 para APIs do Google.
Código de autorização OAuth 2.0
ID do cliente: o ID do cliente necessário para se conectar ao seu serviço do Google de back-end.
Escopos: selecione os escopos necessários do OAuth 2.0 no menu suspenso. Para conferir todos os escopos do OAuth 2.0 compatíveis
para o Serviço do Google necessário, consulte a seção relevante
na página Escopos do OAuth 2.0 para APIs do Google.
Chave secreta do cliente: selecione o secret do Secret Manager que contém a senha associada à chave secreta do cliente.
Versão do secret: selecione a versão do secret.
Ações
Esse conector oferece uma camada de abstração para os objetos do
serviço de back-end conectado. Só é possível acessar os objetos do back-end
por essa abstração. A abstração é exposta a você como ações. Uma Action é uma função de primeira classe disponibilizada para a integração por meio da interface do conector. Uma ação permite fazer
mudanças em uma ou mais entidades e varia de um conector
para outro. No entanto, é possível
que um conector não ofereça suporte a nenhuma ação.
Nesse caso, a lista Actions estará vazia.
Usar a conexão dos Documentos Google em uma integração
Depois de criar a conexão, ela fica disponível na
Application Integration. É possível usar a conexão em uma integração com a tarefa de conectores.
Receber ajuda da comunidade do Google Cloud
Poste suas dúvidas e converse sobre esse conector na comunidade do Google
Cloud em Fóruns do Cloud.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-22 UTC."],[[["\u003cp\u003eThe Google Docs connector allows users to perform supported operations on Google Docs through a defined connector interface.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the connector, users must configure network connectivity, grant specific IAM roles, and enable the Secret Manager API and Connectors API.\u003c/p\u003e\n"],["\u003cp\u003eCreating a connection involves selecting the Google Docs connector, specifying connection details like name, location, and optionally enabling cloud logging and adjusting node settings.\u003c/p\u003e\n"],["\u003cp\u003eThe connector supports OAuth 2.0 authentication, requiring details such as Client ID, Scopes, and Client Secret.\u003c/p\u003e\n"],["\u003cp\u003eThe connector enables abstract actions on Google Docs entities and can be used in Application Integration through the Connectors task, with further guidance available on suspending/resuming connections, monitoring usage, and viewing logs.\u003c/p\u003e\n"]]],[],null,["# Google Docs\n\n| **Preview**\n|\n|\n| This product or feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA products and features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nGoogle Docs\n===========\n\nThe Google Docs connector lets you perform the supported operations on [Google Docs](https://developers.google.com/docs).\n\nBefore you begin\n----------------\n\nBefore using the Google Docs connector, do the following tasks:\n\n- In your Google Cloud project:\n - Ensure that network connectivity is set up. For information about network patterns, see [Network connectivity](/integration-connectors/docs/network-connectivity-private).\n - Grant the [roles/connectors.admin](/integration-connectors/docs/connectors-access-permissions#iam-roles-for-integration-connectors) IAM role to the user configuring the connector.\n - Grant the following IAM roles to the service account that you want to use for the connector:\n - `roles/secretmanager.viewer`\n - `roles/secretmanager.secretAccessor`\n\n A service account is a special type of Google account intended to represent a non-human\n user that needs to authenticate and be authorized to access data in Google APIs.\n If you don't have a service account, you must create a service account. The connector and the service account must belong to the same project. For more\n information, see\n [Creating a service account](/iam/docs/creating-managing-service-accounts#creating).\n - Enable the following services:\n - `secretmanager.googleapis.com` (Secret Manager API)\n - `connectors.googleapis.com` (Connectors API)\n\n To understand how to enable services, see [Enabling services](/service-usage/docs/enable-disable#enabling).\n\n\n If these services or permissions have not been enabled for your project previously, you are prompted to enable them\n when configuring the connector.\n- If you are using the service account authentication instead of OAuth 2.0 authentication, ensure that appropriate permissions are given to the service account. For more information, see [IAM roles and permissions](/iam/docs/permissions-reference).\n\nConfigure the connector\n-----------------------\n\nA connection is specific to a data source. It\nmeans that if you have many data sources, you must create a separate connection\nfor each data source. To create a connection, do the following:\n\n1. In the [Cloud console](https://console.cloud.google.com), go to the **Integration Connectors \\\u003e Connections** page and then select or create a Google Cloud project.\n\n\n [Go to the Connections page](https://console.cloud.google.com/connectors/connections)\n2. Click **+ Create new** to open the **Create Connection** page.\n3. In the **Location** section, choose the location for the connection.\n 1. **Region** : Select a location from the drop-down list.\n\n For the list of all the supported regions, see [Locations](/integration-connectors/docs/locations).\n 2. Click **Next**.\n\n- In the **Connection Details** section, set the following fields:\n 1. **Connector** : Select **Google Docs** from the drop down list of available connectors.\n 2. **Connector version**: Select the connector version from the drop down list of available versions.\n 3. In the **Connection Name** field, enter a name for the connection instance.\n\n Connection names must meet the following criteria:\n - Connection names can use letters, numbers, or hyphens.\n - Letters must be lower-case.\n - Connection names must begin with a letter and end with a letter or number.\n - Connection names cannot exceed 49 characters.\n 4. Optionally, enter a **Description** for the connection instance.\n 5. Optionally, select **Enable cloud logging** if you want to log the connector execution details.\n 6. **Service Account** : Select a service account that has the [required roles](#before-you-begin).\n 7. Optionally, configure the **Connection node settings** :\n\n\n - **Minimum number of nodes**: Enter the minimum number of connection nodes.\n - **Maximum number of nodes**: Enter the maximum number of connection nodes.\n\n A node is a unit (or replica) of a connection that processes transactions.\n More nodes are required to process more transactions for a connection and conversely,\n fewer nodes are required to process fewer transactions.\n To understand how the nodes affect your connector pricing, see\n [Pricing for connection nodes](/integration-connectors/docs/pricing#pricing-for-connection-nodes). If you don't enter any values, by default\n the minimum nodes are set to 2 (for better availability) and the maximum nodes are set to 50.\n | **Note:** You can customize the connection node values only if you are a Pay-as-you-go customer.\n 8. Optionally, click **+ Add label** to add a label to the connection in the form of a key-value pair.\n 9. Click **Next**.\n 10. In the **Authentication** section, enter the authentication details.\n 1. Select an **Authentication type** and enter the relevant details.\n\n You can choose any of the following authentication types:\n - OAuth 2.0 - Authorization code (Google Managed) If you want Google Cloud to manage the client ID and client secret, instead of you creating the client ID and client secret, select this option.\n\n - OAuth 2.0 - Authorization code\n 2. To understand how to configure these authentication types, see [Configure authentication](#configure-auth).\n 3. Click **Next**.\n 11. **Review**: Review your connection and authentication details.\n 12. Click **Create**.\n\n ### Configure authentication\n\n Enter the details based on the authentication you want to use.\n - **OAuth 2.0 - Authorization code (Google Managed)**\n\n Google Cloud manages the client ID and client secret and you don't need to specify them.\n - **Scopes** : Select the required OAuth 2.0 scopes from the drop-down. To view all the supported OAuth 2.0 scopes for your required Google service, see the relevant section in the [OAuth 2.0 Scopes for Google APIs](https://developers.google.com/identity/protocols/oauth2/scopes) page.\n - **OAuth 2.0 - Authorization code**\n - **Client ID**: The client ID required to connect to your backend Google service.\n - **Scopes** : Select the required OAuth 2.0 scopes from the drop-down. To view all the supported OAuth 2.0 scopes for your required Google service, see the relevant section in the [OAuth 2.0 Scopes for Google APIs](https://developers.google.com/identity/protocols/oauth2/scopes) page.\n - **Client Secret**: Select the Secret Manager secret containing the password associated with the client secret.\n - **Secret version**: Select the secret version.\n\n Actions\n -------\n\n\n This connector provides a layer of abstraction for the objects of\n the connected backend service. You can access the backend's objects\n only through this abstraction. The abstraction is exposed\n to you as actions. An `Action` is a first class\n function that is made available to the integration\n through the connector interface. An action lets you make\n changes to an entity or entities, and varies from connector\n to connector. However, it is possible\n that a connector doesn't support any action,\n in which case the `Actions` list will be empty.\n | **Note:** You can view the actions of the connector in the [Connectors task](/application-integration/docs/connectors-task).\n\n Use the Google Docs connection in an integration\n ------------------------------------------------\n\n After you create the connection, it becomes available in\n Application Integration. You can use the connection in an integration through the [Connectors task](/application-integration/docs/configure-connectors-task).\n\n Get help from the Google Cloud community\n ----------------------------------------\n\n You can post your questions and discuss this connector in the Google Cloud community at [Cloud Forums](https://www.googlecloudcommunity.com/gc/Integration-Services/bd-p/cloud-integration-services).\n\n What's next\n -----------\n\n - Understand how to [suspend and resume a connection](/integration-connectors/docs/suspend-resume-connection).\n - Understand how to [monitor connector usage](/integration-connectors/docs/cloud-monitoring).\n - Understand how to [view connector logs](/integration-connectors/docs/view-connector-logs)."]]
