Configurar o spoke da planilha Google

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 4 min. de leitura
  • Configure uma integração de saída entre sua instância ServiceNow e as Google Planilhas configurando uma conexão e um registro de credencial.

    Antes de Iniciar

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

    Por Que e Quando Desempenhar Esta Tarefa

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

    Configurar a aplicação OAuth na Google API de planilhas

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

    Antes de Iniciar

    • Criar uma conta comercial 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 da aplicação (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 PROCURAR para selecionar uma organização.
      6. Selecione CRIAR.
        O projeto é 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 API de planilhas.
      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 de API de planilhas.
      5. Selecione HABILITAR.
        As Google APIs de planilhas 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 Google Planilhas.
      2. Preencha o formulário.
        Tabela 1. Credenciais da API do Google Planilhas
        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 Google Planilhas.
        Quais dados você acessará? * Tipo de dados que seu ServiceNow acessará por meio das APIs.
        Dica:
        Selecione Dados do usuário.
      3. Clique em PRÓXIMO.
      4. Preencha o formulário.
        Tabela 2. Credenciais da API do Google Planilhas
        Campo Descrição Obrigatório?
        Nome da app Nome do aplicativo OAuth. Sim
        E-mail de suporte ao usuário E-mail no qual os usuários podem enviar consultas a você sobre o consentimento. Sim
        Arquivo de logotipo a ser carregado Logotipo que representa a aplicação OAuth. Não
        Informações de contato do desenvolvedor Google entrará em contato com o desenvolvedor da aplicação OAuth se houver alguma mudança 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.Pesquise no Google Planilhas nos escopos.
      3. Selecione um ou mais escopos.
      4. Clique em ATUALIZAR.
      5. Clique em SALVAR E CONTINUAR.
    6. Gera 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 de download para baixar o arquivo de credenciais do OAuth.
    10. Clique em CONCLUÍDO.
      Você criou a aplicação OAuth em Google Workspace.

    Criar conexão e registro de credencial para Google spoke de planilhas

    Crie uma conexão e um registro de credencial que contenha os detalhes necessários para se conectar à Google Planilhas Interfaces de programação da aplicação (API) na 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 do Google.Pesquise o alias do Google Planilhas no alias do Flow Designer.
    4. No cartão do GoogleSheets, clique em Exibir detalhes.
    5. Clique em Configurar, conforme mostrado na imagem.Botão Configurar no alias do Google Planilhas.
    6. Preencha o formulário.
      Tabela 3. Configurar conexão
      Campo Descrição
      Nome da conexão Nome da conexão.
      Nota:
      O campo é somente leitura.
      URL de conexão O URL usado para conexão com as APIs do Google Planilhas. 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 Google Planilhas.
      Nome da entidade OAuth Nome do perfil de entidade OAuth. Este campo é definido automaticamente como Google Sheets Spoke OAuth.
      ID do cliente OAuth ID de cliente da aplicação Google Planilhas que você registrou no G Suite.
      Segredo do cliente OAuth Segredo do cliente gerado quando você registrou a aplicação no Console de API do Google.
      URL de redirecionamento do OAuth O 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.