Configurar o spoke Google da planilha

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 4 min. de leitura

    • Configure uma integração de saída entre sua instância ServiceNow e as planilhas Google configurando uma conexão e um registro de credencial.

    Antes de Iniciar

    • Solicite a assinatura do Integration Hub.
    • Ativar o Google plug-in Spoke do Planilhas
    • Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    A API Google Sheets autentica as solicitações da sua instância ServiceNow por meio de uma aplicação OAuth. Você deve Configurar app OAuth na API Google Planilhas visitando https://console.developers.google.com/. O registro de conexão e credenciais contém as informações que a API Google Sheets deve autenticar as solicitações da sua instância ServiceNow.

    Configurar app OAuth na API Google Planilhas

    Configure uma aplicação OAuth na Google Sheets API para habilitar a autenticação de solicitações da sua instância ServiceNow.

    Antes de Iniciar

    • Criar uma conta corporativa em https://console.developers.google.com/
    • Crie um domínio e um endereço de e-mail associados ao domínio. Por exemplo, www.mydomain.com e jane-admin@mydomain.com.
      Nota:
      Você só pode registrar um endereço de e-mail por domínio no Google Workspace.
    • Função necessária: administrador

    Procedimento

    1. Configure um projeto no Google Workspace.
      O projeto inclui os detalhes da aplicação OAuth e as permissões da Interface de programação de aplicações (API), se aplicável.
      1. Faça login em https://console.developers.google.com/ com o mesmo ID de e-mail de domínio e senha mencionados nos pré-requisitos.
      2. Selecione o botão.

        Botão de criação de projeto no Google Workspace.

      3. Selecione NOVO PROJETO.

        Clique no botão Novo projeto no Google Workspace.

      4. No campo Nome do projeto*, insira um nome exclusivo para o projeto.
      5. No campo Local*, selecione BROWSE para selecionar uma organização.
      6. Selecione CRIAR.
        O projeto foi criado.
      7. Selecione o botão.

        Selecione o projeto.

    2. Selecione o projeto que você criou.

      Seleção de projeto na API do Google Planilhas.

    3. Habilite a Google Planilhas API.
      1. Clique em +HABILITAR APIS E SERVIÇOS.

        API do Google Planilhas Botão Habilitar APIs e serviços.

      2. Na página Bem-vindo(a) à Biblioteca de APIs, insira Planilhas Google na caixa de pesquisa.
      3. Pressione Enter.
      4. Selecione o botão Google Sheets API.
      5. Selecione HABILITAR.
        As Google Planilhas APIs estão habilitadas no seu projeto.
    4. Crie o aplicativo OAuth e as credenciais.
      1. Selecione CRIAR CREDENCIAIS.
        Clique no botão Credenciais da API do Planilhas Google.
      2. Preencha o formulário.
        Tabela 1. Credenciais da API do Planilhas Google
        Campo Descrição
        Selecione uma API* Nome da API para a qual você está criando as credenciais.
        Nota:
        Certifique-se de selecionar a API do Planilhas Google.
        Quais dados você acessará? * Tipo de dados que seu ServiceNow acessará por meio das APIs.
        Dica:
        Selecione Dados do usuário.
      3. Clique em AVANÇAR.
      4. Preencha o formulário.
        Tabela 2. Credenciais da API do Planilhas Google
        Campo Descrição Obrigatório?
        Nome da app Nome do aplicativo OAuth. Sim
        E-mail de suporte ao usuário E-mail para o qual os usuários podem enviar consultas sobre o consentimento. Sim
        Arquivo de logotipo para carregar Logotipo que representa o aplicativo OAuth. Não
        Informações de contato do desenvolvedor Google entrará em contato com o desenvolvedor do app OAuth se houver mudanças no projeto. Sim
      5. Clique em SALVAR E CONTINUAR.
    5. Opcional: Defina os escopos da API.
      Os escopos de API permitem que você selecione APIs específicas. Por exemplo, o escopo /auth/spreadsheets permite criar, editar ou remover planilhas.
      1. Clique em ADICIONAR OU REMOVER ESCOPOS.
      2. Insira a API de planilhas do Google, conforme mostrado na imagem.
        Pesquisar planilhas do Google nos escopos.
      3. Selecione um ou mais escopos.
      4. Clique em ATUALIZAR.
      5. Clique em SALVAR E CONTINUAR.
    6. Gerar ID de cliente OAuth.
      1. Na lista Tipo de aplicação*, selecione Aplicação web.
      2. No campo Nome*, insira um nome exclusivo do cliente OAuth.
    7. No título URIs de redirecionamento autorizados, clique em + ADICIONAR URI.
    8. No campo URI, insira o URI de redirecionamento no seguinte formato: https://instance.service-now.com/oauth_redirect.do.
    9. Clique em CRIAR.
      Os detalhes do OAuth são gerados em um arquivo JSON.
      Dica:
      Clique em DOWNLOAD para baixar o arquivo JSON para referência posterior.

      Botão Baixar para baixar o arquivo de credenciais do OAuth.

    10. Clique em CONCLUÍDO.
      Você criou a aplicação OAuth em Google Workspace.

    Criar registro de conexão e credencial para Google Spoke Planilhas

    Crie um registro de conexão e credencial que contenha os detalhes necessários para se conectar às Google Planilhas Interfaces de programação de aplicações (API) no Google Workspace.

    Antes de Iniciar

    Procedimento

    1. Navegar até Todos > Automação de Processo > Flow Designer.
    2. Clique em Conexões.
    3. No campo Pesquisar todas as conexões, insira Planilhas Google.Pesquisar alias do Planilhas Google no alias do Flow Designer.
    4. No cartão do GoogleSheets, clique em Exibir detalhes.
    5. Clique em Configurar, conforme mostrado na imagem.Configure o botão no alias do Planilhas Google.
    6. Preencha o formulário.
      Tabela 3. Configurar conexão
      Campo Descrição
      Nome da conexão O nome da conexão.
      Nota:
      O campo é somente leitura.
      URL de Conexão O URL usado para conexão com as APIs do Planilhas Google. Este campo é definido automaticamente como https://sheets.googleapis.com/v4/spreadsheets
      Nome da Credencial Nome da credencial. Este campo é definido automaticamente como Credencial do Spoke do Planilhas Google.
      Nome da entidade OAuth Nome do perfil da entidade OAuth. Este campo é definido automaticamente como Spoke OAuth do Google Planilhas.
      ID do cliente OAuth ID de cliente da aplicação Planilhas Google que você registrou no G Suite.
      Segredo do cliente OAuth Segredo do cliente gerado quando você registrou a aplicação no Console de APIs do Google.
      URL de redirecionamento do OAuth A URL de redirecionamento. O formato da URL é https://<your-instance> .service-now.com/oauth_redirect.do
    7. Clique em Criar e obter token do OAuth.