O seu trabalho exige que passe muito tempo no Google Sheets? Pode usar a ação segura baseada em OAuth do Looker para enviar ficheiros CSV diretamente do Looker para o Google Sheets de forma única ou recorrente.
A ação do Google Sheets está integrada com o Looker através do Centro de ações do Looker. Depois de o administrador do Looker ativar a ação do Google Sheets no centro de ações, os utilizadores podem selecionar o Google Sheets como um possível destino quando enviam ou agendam Looks ou Explores.
Esta página explica aos administradores como ativar a ação do Google Sheets no Looker. Também descreve como qualquer utilizador que tenha as autorizações adequadas pode enviar ou agendar envios em formato CSV para uma folha de cálculo do Google Sheets.
Ativar a ação do Google Sheets no Looker
Os administradores do Looker podem ativar a ação do Google Sheets no Looker através dos seguintes passos:
Aceda ao painel de Administração e, em Plataforma, aceda à página Ações.
Na lista de ações do centro de ações, desloque a página até ao Google Sheets e clique no botão Ativar.
Na página de ação do Google Sheets, clique no botão
Ativado para o ativar e clique em
Guardar.
Quando regressa à lista de ações do centro de ações, a ação do Google Sheets deve estar ativada.
Agora, os utilizadores e o administrador, se tiverem send_to_integrationautorizações, podem enviar ou agendar Looks ou Explores em formato CSV para uma folha de cálculo do Google Sheets.
Fornecer dados em formato CSV a uma folha de cálculo do Google Sheets
Qualquer utilizador do Looker com autorizações send_to_integration pode enviar ou agendar Looks ou Explores em formato CSV para uma Folha de cálculo do Google Sheets.
O Google Sheets está limitado a 10 milhões de células para toda a folha. Se a tabela de dados tiver colunas, linhas ou separadores que excedam este limite, todas as entregas à integração do Google Sheets falham.
Siga estes passos para preparar os dados antes de os enviar ou agendar:
Escalabilidade horizontal: se a tabela de dados contiver mais de 26 colunas e planear importar os dados para uma folha de cálculo do Google Sheets existente, tem de expandir manualmente a folha de cálculo do Google Sheets antes de poder importar os dados para a mesma.
Escalabilidade vertical: se a tabela de dados contiver mais de 1000 linhas, o Looker adiciona essas linhas à sua folha de cálculo do Google Sheets por predefinição.
Substituição: se for importar os dados para uma folha de cálculo do Google Sheets existente, escreva as fórmulas num separador separado da folha de cálculo do Google Sheets para preservar a lógica nas fórmulas. Se usar a função de substituição da ação do Google Sheets, a ação atualiza dinamicamente a sua folha de cálculo do Google Sheets, e os seus dados são carregados automaticamente no primeiro separador ou no separador mais à esquerda da folha de cálculo do Google Sheets. Se preferir criar uma nova folha de cálculo com cada entrega de dados para ter um histórico completo dos seus dados e poder acompanhar as alterações ao longo do tempo, não use a função de substituição da ação do Google Sheets.
Para enviar ou agendar o seu conteúdo, siga estes passos:
No Agendador, junto a Para onde devem ir estes dados?, selecione Google Sheets como destino de entrega.
Se estiver a fazer o fornecimento para o Google Drive pela primeira vez, tem de se autenticar com as suas credenciais Google. Clique em Iniciar sessão com o Google, especifique a sua Conta Google e, de seguida, clique em Permitir para associar a sua conta do Looker às suas credenciais do Google OAuth. Só pode associar um conjunto de credenciais do Google OAuth 2.0 a esta integração.
No agendador, clique em Validar credenciais para carregar o Google Drive.
No menu pendente Selecionar Drive para guardar ficheiro, escolha o Google Drive onde o ficheiro CSV vai ser guardado.
Em seguida, pode introduzir o URL de uma pasta neste Drive ou obter todas as pastas no seu Drive.
No campo URL de destino do Google Drive, introduza o URL completo do Google Drive da pasta onde quer guardar os dados. Por exemplo: https://drive.google.com/corp/drive/folders/abcxyz. Se este URL não estiver acessível, os seus dados são guardados na pasta raiz do Google Drive.
No menu pendente Selecionar obtenção para obter uma lista de pastas nesta unidade, selecione Obter. Depois de o diálogo do agendador ser atualizado, no menu pendente Selecionar pasta para guardar o ficheiro, selecione a pasta do Google Drive onde o ficheiro CSV vai ser guardado.
Especifique o nome do ficheiro do Google Sheets no campo Introduza um nome de ficheiro. Não tem de incluir a extensão do ficheiro. A ação do Google Sheets anexa-a automaticamente durante a entrega.
No menu pendente Substituir ficheiros existentes, selecione Sim ou Não. Se selecionar Não, é gerada uma nova folha de cálculo do Google Sheets com uma captura instantânea dos seus dados em cada entrega de dados. Se selecionar Sim, os dados são carregados no primeiro separador ou no separador mais à esquerda da sua folha de cálculo do Google Sheets existente.
Devido aos limites de células do Google Sheets, se escolher a opção de substituição, tenha em atenção que os separadores adicionados durante cada entrega não podem fazer com que a folha exceda o limite de 10 milhões de células. Quando o limite de células é excedido, as programações subsequentes falham.
As opções avançadas para CSVs incluem um limite e um formato personalizáveis. Clique em Enviar ou Agendar.
Atualize a pasta do Google Drive para ver a entrega do ficheiro.
[[["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-20 UTC."],[],[],null,["# Looker actions – Google Sheets\n\n| **Note:** You can also connect Google Sheets to Looker directly using the **Connected Sheets for Looker** feature. This feature lets users interactively explore data from LookML models through the familiar Google Sheets spreadsheet interface. Sheets users will have access to governed data from the databases that are supported by Looker. Exploration is intuitive since Connected Sheets presents an organized view of the model with views, fields, and measures just as they were defined in Looker. Looker data through Connected Sheets presents Looker data in standard Sheets constructs, such as pivot tables, charts, and formulas, allowing for flexibility of analysis through familiar constructs. For more information, see the [Using Connected Sheets for Looker](/looker/docs/connected-sheets) documentation page. For an overview of all the ways that Looker integrates with Google Sheets, see the [How Looker integrates with Google](/looker/docs/looker-google-integrations#google_sheets) documentation page.\n\u003e Customer-hosted instances may be unable to enable actions from the Looker Action Hub, especially actions that [support streamed results](/looker/docs/action-hub#uses_streaming) or that use [OAuth](/looker/docs/action-hub#configuring_an_action_for_oauth), if the customer-hosted Looker instance does not fulfill the [Looker Action Hub requirements](/looker/docs/action-hub#looker_action_hub_requirements).\n\u003e\n\u003e See the [Sharing data through an action hub](/looker/docs/action-hub#considerations_for_customer-hosted_instances) documentation page for suggested solutions to this potential issue.\n\n\nDoes your work require you to spend a lot of time in Google Sheets? You can use Looker's secure, OAuth-based action to send CSVs directly from Looker to Google Sheets on a one-off or recurring basis.\n\n\nThe Google Sheets action is integrated with Looker through the [Looker Action Hub](/looker/docs/admin-panel-platform-actions). Once the Looker admin has enabled the Google Sheets action in the Action Hub, users can select Google Sheets as a possible destination when sending or scheduling Looks or Explores.\n\n\nThis page walks admins through enabling the Google Sheets action in Looker. It also describes how any user who has the appropriate [permissions](/looker/docs/admin-panel-users-roles#permissions_list) can send or schedule deliveries in CSV format to a Google Sheet.\n| **Note:** If you have a permission that provides access to only select pages in the Admin panel, such as [`manage_schedules`](/looker/docs/admin-panel-users-roles#manage_schedules), [`manage_themes`](/looker/docs/admin-panel-users-roles#manage_themes), or [`see_admin`](/looker/docs/admin-panel-users-roles#see_admin), but you don't have the [Admin role](/looker/docs/admin-panel-users-roles#default_roles), the page or pages that are described here may not be visible to you in the Admin panel.\n\n\u003cbr /\u003e\n\nEnabling the Google Sheets action in Looker\n-------------------------------------------\n\nLooker admins can enable the Google Sheets action in Looker with the following steps:\n\n1. Go the **Admin** panel and, under **Platform** , go to the **Actions** page.\n2. On the list of Action Hub actions, scroll to Google Sheets and click the **Enable** button.\n3. On the **Google Sheets** action page, click the **Enabled** toggle to the on position, and click **Save**.\n4. When you return to the list of Action Hub actions, your Google Sheets action should be enabled.\n\n\nYou and your users --- if they have `send_to_integration` permissions --- can now send or schedule Looks or Explores in CSV format to a Google Sheet.\n\nDelivering data in CSV format to a Google Sheet\n-----------------------------------------------\n\n\nAny Looker user who has `send_to_integration` permissions can send or schedule Looks or Explores in CSV format to a Google Sheet.\n\u003e Google Sheets are [limited to 10 million cells](https://support.google.com/drive/answer/37603) for the entire Sheet. If your data table has columns, rows, or tabs that exceed this limit, any deliveries to the Google Sheet integration will fail.\n\nTo prepare your data before sending or scheduling it, follow these steps:\n\n- **Horizontal scaling:** If your data table contains more than 26 columns and you plan to import the data to an existing Google Sheet, you'll need to manually expand the Google Sheet before you can import your data into it.\n- **Vertical scaling:** If your data table contains more than 1,000 rows, Looker will add those rows to your Google Sheet by default.\n- **Overwriting:** If you're going to import your data into an existing Google Sheet, write any formulas on a separate tab of your Google Sheet to preserve the logic in your formulas. If you use the Google Sheets action's overwrite function, the action dynamically updates your Google Sheet, and your data will automatically be loaded into the first or leftmost tab of your Google Sheet. If you'd prefer to create a new spreadsheet with each data delivery so that you have a full history of your data and can track changes over time, don't use the Google Sheets action's overwrite function.\n\n\nTo send or schedule your content, follow these steps:\n\n1. From the [Scheduler](/looker/docs/delivering-looks-explores), next to **Where should this data go?** , select **Google Sheets** as your delivery destination.\n2. If you're delivering to Google Drive for the first time, you'll need to authenticate with your Google credentials. Click **Sign in with Google** , specify your Google Account, and then click **Allow** to connect your Looker account to your Google OAuth credentials. You can connect only one set of Google OAuth 2.0 credentials to this integration.\n3. In the Scheduler, click **Verify credentials** to load your Google Drive.\n4. From the **Select Drive to save file** drop-down, choose the Google Drive where your CSV file will be saved.\n\n Next, you can either enter the URL for a folder in this Drive or fetch all folders in your Drive.\n - In the **Google Drive Destination URL** field, enter the full Google Drive URL of the folder where you want to save your data. For example: `https://drive.google.com/corp/drive/folders/abcxyz`. If this URL isn't accessible, your data will be saved to the root folder of your Google Drive.\n - From the **Select Fetch to fetch a list of folders in this drive** drop-down, select **Fetch** . After the Scheduler dialog refreshes, from the **Select folder to save file** drop-down, select the Google Drive folder where your CSV file will be saved.\n5. Specify the name of your Google Sheet file in the **Enter a filename** field. You don't need to include the file extension --- the Google Sheets action will automatically append it during delivery.\n6. In the **Overwrite Existing Files** drop-down, select **Yes** or **No** . Selecting **No** will generate a new Google Sheet with a snapshot of your data with every data delivery. Selecting **Yes** will load your data in the first or leftmost tab of your existing Google Sheet.\n\u003e Because of [Google Sheets cell limits](https://support.google.com/drive/answer/37603), if you choose the overwrite option, keep in mind that the tabs that are added during each delivery cannot cause the Sheet to exceed the 10 million cell limit. Once the cell limit is exceeded, subsequent schedules will fail.\n7. Advanced options for CSVs include customizable [limit](/looker/docs/delivering-looks-explores#limit) and [format](/looker/docs/delivering-looks-explores#format_options). Click **Send** or **Schedule**.\n8. Refresh your Google Drive folder to see your file delivery.\n\nSwitching Google Accounts\n-------------------------\n\nTo associate a different Google Account with this action, you must delete the account's connection to the Looker instance. To learn more, see [Manage connections between your Google Account and third-parties](https://support.google.com/accounts/answer/13533235).\n\n\u003cbr /\u003e"]]
