Seu trabalho exige que você passe muito tempo no Planilhas Google? Você pode usar a ação segura do Looker baseada em OAuth para enviar CSVs diretamente do Looker para as Planilhas Google de maneira única ou recorrente.
A ação das Planilhas Google é integrada ao Looker pelo Looker Action Hub. Depois que o administrador do Looker ativar a ação das Planilhas Google no Action Hub, os usuários poderão selecionar as Planilhas Google como possível destino ao enviar ou programar Looks ou Análises.
Nesta página, os administradores aprendem a ativar a ação das Planilhas Google no Looker. Ela também descreve como os usuários com as permissões apropriadas podem enviar ou agendar entregas no formato CSV para uma planilha Google.
Ativar a ação das Planilhas Google no Looker
Para ativar a ação das Planilhas Google no Looker, os administradores podem seguir estas etapas:
Acesse o painel Administrador e, em Plataforma, acesse a página Ações.
Na lista de ações do hub de ações, role até Planilhas Google e clique no botão Ativar.
Na página de ações das Planilhas Google, ative o botão Ativado e clique em Salvar.
Quando você voltar à lista de ações do hub de ações, a ação das Planilhas Google vai estar ativada.
Você e seus usuários, se eles tiverem as permissões send_to_integration, agora podem enviar ou programar Looks ou Análises no formato CSV para um arquivo das Planilhas Google.
Enviar dados no formato CSV para uma planilha Google
Qualquer usuário do Looker com as permissões send_to_integration pode enviar ou programar Looks ou Análises no formato CSV para um arquivo das Planilhas Google.
As Planilhas Google têm um limite de 10 milhões de células para toda a planilha. Se a tabela de dados tiver colunas, linhas ou guias que excedem esse limite, os envios da integração do Planilhas Google vão falhar.
Para preparar seus dados antes de enviá-los ou programá-los, siga estas etapas:
Escalonamento horizontal:se a tabela de dados tiver mais de 26 colunas e você quiser importar os dados para uma Planilha Google, será necessário expandi-la manualmente antes de importar os dados para ela.
Escalonamento vertical:se a tabela de dados tiver mais de mil linhas, o Looker as adicionará à planilha por padrão.
Substituição: se você for importar seus dados para uma planilha Google, escreva qualquer fórmula em uma guia separada da planilha para preservar a lógica das fórmulas. Se você usar a função "Substituir" da ação do Planilhas Google, ela vai atualizar dinamicamente sua planilha, e seus dados serão carregados automaticamente na primeira ou mais à esquerda da planilha. Se você preferir criar uma nova planilha para cada envio de dados para ter um histórico completo e poder acompanhar as alterações ao longo do tempo, não use a função de substituição da ação do Planilhas Google.
Para enviar ou programar seu conteúdo, siga estas etapas:
No Programador, ao lado de Para onde devem ir esses dados?, selecione Planilhas Google como destino de entrega.
Se você estiver entregando no Google Drive pela primeira vez, precisará fazer a autenticação com suas credenciais do Google. Clique em Fazer login com o Google, especifique sua Conta do Google e clique em Permitir para conectar sua conta do Looker às credenciais de OAuth do Google. Você pode conectar apenas um conjunto de credenciais do OAuth 2.0 do Google a esta integração.
No programador, clique em Verificar credenciais para carregar o Google Drive.
No menu suspenso Selecionar o Drive para salvar o arquivo, escolha o Google Drive onde o arquivo CSV será salvo.
Em seguida, digite o URL de uma pasta neste Drive ou busque todas as pastas no Drive.
No campo URL de destino do Google Drive, insira o URL completo do Google Drive da pasta em que você quer salvar os dados. Por exemplo, https://drive.google.com/corp/drive/folders/abcxyz. Se o URL não estiver acessível, seus dados serão salvos na pasta raiz do Google Drive.
No menu suspenso Selecione "Buscar para buscar uma lista de pastas neste drive", selecione Buscar. Depois que a caixa de diálogo "Programador" for atualizada, no menu suspenso Selecionar pasta para salvar o arquivo, escolha a pasta do Google Drive em que o arquivo CSV será salvo.
Especifique o nome do arquivo das Planilhas Google no campo Inserir um nome de arquivo. Você não precisa incluir a extensão do arquivo. A ação do Planilhas Google o anexará automaticamente durante o envio.
No menu suspenso Substituir arquivos existentes, selecione Sim ou Não. Se você selecionar Não, será gerada uma nova Planilha Google com um resumo dos seus dados a cada envio. Ao selecionar Sim, os dados serão carregados na primeira guia ou mais à esquerda da planilha Google.
Devido aos limites de células do Planilhas Google, se você escolher a opção de substituição, lembre-se de que as guias adicionadas durante cada envio não podem fazer com que a planilha exceda o limite de 10 milhões de células. Quando o limite de células for excedido, as programações subsequentes vão falhar.
As opções avançadas para CSVs incluem limite e formato personalizáveis. Clique em Enviar ou Programar.
Atualize sua pasta do Google Drive para conferir a entrega de arquivos.
[[["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-25 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"]]
