Como gerenciar bibliotecas e APIs Cloud

Acesse os produtos e os serviços do Google Cloud Platform com seu código usando as APIs Cloud. Essas APIs Cloud expõem uma interface REST JSON simples que é possível chamar por meio de bibliotecas de cliente.

Neste documento, descrevemos como ativar APIs Cloud, como gerenciar contas de serviço e variáveis de ambiente para acessar APIs localmente e como adicionar bibliotecas de cliente do Cloud para Java ao projeto do Maven.

Antes de começar

Siga o guia de início rápido para instalar e configurar o IntelliJ IDEA.

Como adicionar as bibliotecas de cliente do Cloud

Para adicionar bibliotecas ao seu projeto no IntelliJ, faça o seguinte:

Para projetos do Maven

  1. Selecione Ferramentas > Google Cloud Tools > Adicionar bibliotecas do Cloud e gerenciar APIs do Cloud.
  2. A caixa de diálogo Adicionar bibliotecas do Cloud mostra as bibliotecas compatíveis.

    Captura de tela que mostra a caixa de diálogo "Add Cloud Libraries dialog". Esta caixa de diálogo fornece um menu suspenso para selecionar um módulo em que as bibliotecas serão adicionadas, mostra a lista de APIs disponíveis para adicionar e fornece uma área de trabalho que mostra informações sobre a API.
  3. Verifique se o projeto e a conta corretos são mostrados no campo Projeto do GCP. Caso contrário, clique nas reticências para escolher o projeto e a conta corretos.
  4. No menu suspenso Adicionar biblioteca de cliente do Google ao módulo, selecione o módulo a que você quer adicionar a biblioteca.
  5. No menu suspenso do Google Cloud Java, selecione a versão BOM do Google Cloud Java que você quer usar.
  6. O Google Cloud Java resolve os conflitos de versão entre as bibliotecas adicionando a lista de materiais (BOM, na sigla em inglês) do Google Cloud Java ao arquivo pom.xml dos projetos.

  7. Marque a caixa de seleção de cada biblioteca que você quer adicionar.
  8. Clique em Continuar.
  9. A caixa de diálogo Ativar APIs do GCP e gerenciar confirmação das contas de serviço é exibida.

    Captura de tela mostrando a caixa de diálogo de confirmação para adicionar papéis a uma nova conta de serviço e inserir um caminho para o download da chave.A caixa de diálogo também exibe as APIs que serão adicionadas ao projeto.
  10. No campo Nome da conta de serviço, mantenha o nome padrão ou insira um novo.
  11. No campo Caminho de download, navegue até o local onde quer salvar a chave da conta de serviço.
  12. Se sua API exigir, selecione os papéis que você quer adicionar à conta de serviço.
  13. Clique em OK.
  14. Captura de tela mostrando o caminho da chave e a confirmação de que a conta de serviço foi criada.

    O IntelliJ faz as seguintes atualizações:

    • Ele adiciona as dependências selecionadas ao seu pom.xml.
    • Ele ativa as APIs selecionadas ao Google Cloud Platform.
    • Ele cria a conta de serviço e faz o download da chave dela no local especificado.
  15. Para acessar as APIs Google Cloud localmente, defina as variáveis de ambiente GOOGLE_APPLICATION_CREDENTIALS e GOOGLE_CLOUD_PROJECT no servidor de desenvolvimento local ou em qualquer uma das configurações executadas localmente:
    1. Clique no ícone "Copiar" para copiar as variáveis para a área de transferência.
    2. Edite sua configuração de execução.
    3. Na seção Variáveis de ambiente, clique no ícone "Colar".
    4. No servidor de aplicativos local, esta seção aparece na guia Inicialização/conexão.

    5. As variáveis de ambiente são inseridas automaticamente para você.

Para projetos que não são do Maven

  1. Selecione Ferramentas > Google Cloud Tools > Gerenciar APIs do Cloud.
  2. A caixa de diálogo Gerenciar APIs do Google Cloud mostra as bibliotecas compatíveis.

    Captura de tela que mostra a caixa de diálogo "Add Cloud Libraries dialog". Esta caixa de diálogo exibe a lista de APIs disponíveis para adicionar e fornece uma área de trabalho que exibe informações sobre a API.
  3. Verifique se o projeto e a conta corretos são mostrados no campo Projeto do GCP. Caso contrário, clique nas reticências para escolher o projeto e a conta corretos.
  4. Marque a caixa de seleção de cada biblioteca que você quer adicionar.
  5. Clique em Continuar.
  6. A caixa de diálogo Ativar APIs do GCP e gerenciar confirmação das contas de serviço é exibida.

    Captura de tela mostrando a caixa de diálogo de confirmação para adicionar papéis a uma nova conta de serviço e inserir um caminho para o download da chave.A caixa de diálogo também exibe as APIs que serão adicionadas ao projeto.
  7. No campo Nome da conta de serviço, mantenha o nome padrão ou insira um novo.
  8. No campo Caminho de download, navegue até o local onde quer salvar a chave da conta de serviço.
  9. Se sua API exigir, selecione os papéis que você quer adicionar à conta de serviço.
  10. Clique em OK.
  11. Captura de tela mostrando o caminho da chave e a confirmação de que a conta de serviço foi criada.

    O IntelliJ faz as seguintes atualizações:

    • Ele ativa as APIs selecionadas ao Google Cloud Platform.
    • Ele cria a conta de serviço e faz o download da chave dela no local especificado.
  12. Para acessar as APIs Google Cloud localmente, defina as variáveis de ambiente GOOGLE_APPLICATION_CREDENTIALS e GOOGLE_CLOUD_PROJECT no servidor de desenvolvimento local ou em qualquer uma das configurações executadas localmente:
    1. Clique no ícone "Copiar" para copiar as variáveis para a área de transferência.
    2. Edite sua configuração de execução.
    3. Na seção Variáveis de ambiente, clique no ícone "Colar".
    4. No servidor de aplicativos local, esta seção aparece na guia Inicialização/conexão.

    5. As variáveis de ambiente são inseridas automaticamente para você.

A seguir

  • Explore o código do plug-in e informe problemas no GitHub ou faça uma pergunta no Stack Overflow.
Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Cloud Tools for IntelliJ
Precisa de ajuda? Acesse nossa página de suporte.