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, você verá como ativar APIs do Cloud, gerenciar contas de serviço e variáveis de ambiente para acessar APIs localmente e adicionar bibliotecas de cliente do Cloud para Java ao projeto do Maven.

Observação: para projetos que não são do Maven, o Cloud Code não adiciona as bibliotecas de cliente do Cloud à compilação, mas é compatível com os outros recursos aqui descritos.

Observação: veja abaixo os ambientes de desenvolvimento integrado compatíveis com este recurso:

• IntelliJ IDEA - Ultimate
• IntelliJ IDEA — Community
• Outros ambientes de desenvolvimento integrado baseados na plataforma IntelliJ

Observação: o Java 7 não é compatível com aplicativos no ambiente padrão do App Engine. Consulte a página do GitHub para saber mais sobre as plataformas compatíveis.

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 > Cloud Code > Adicionar bibliotecas do Cloud e Gerenciar APIs do Cloud.

A caixa de diálogo Adicionar bibliotecas de cliente do Cloud mostra as bibliotecas compatíveis.


2. 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.
3. No menu suspenso Adicionar biblioteca de cliente do Google ao módulo, selecione o módulo a que você quer adicionar a biblioteca.
4. No menu suspenso do Google Cloud Java, selecione a versão BOM do Google Cloud Java que você quer usar.

O Google Cloud para Java resolve os conflitos de versão entre as bibliotecas adicionando a lista de materiais (BOM, na sigla em inglês) do Google Cloud para Java ao arquivo pom.xml dos projetos.

5. Marque a caixa de seleção de cada biblioteca que você quer adicionar.
Antes de acessar algumas APIs, será necessário ativá-las no Google Cloud Platform. Para essas APIs, marcar a caixa de seleção seleciona automaticamente a opção Ativar a API no Google Cloud Platform.
6. Clique em Continuar.

A caixa de diálogo Ativar APIs do GCP e gerenciar confirmação das contas de serviço é exibida.


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.
Mantenha a chave em local seguro e nunca a marque no controle de origem.
9. Se sua API exigir, selecione os papéis que você quer adicionar à conta de serviço.
10. Clique em OK.


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.
11. Para acessar as APIs do 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".

No servidor de aplicativos local, esta seção aparece na guia Inicialização/conexão.

4. As variáveis de ambiente são inseridas automaticamente para você.
Caso esteja usando o padrão do App Engine e tenha configurações de execução locais, a caixa de diálogo de confirmação exibirá essas configurações de execução. Selecione as configurações em que você quer adicionar essas variáveis de ambiente e clique em Adicionar variáveis.

Para projetos que não são do Maven

1. Selecione Ferramentas > Cloud Code > Gerenciar APIs do Cloud.

A caixa de diálogo Gerenciar APIs do Google Cloud mostra as bibliotecas compatíveis.


2. 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.
3. Marque a caixa de seleção de cada biblioteca que você quer adicionar.
Antes de acessar algumas APIs, será necessário ativá-las no Google Cloud Platform. Para essas APIs, marcar a caixa de seleção seleciona automaticamente a opção Ativar a API no Google Cloud Platform.
4. Clique em Continuar.

A caixa de diálogo Ativar APIs do GCP e gerenciar confirmação das contas de serviço é exibida.


5. No campo Nome da conta de serviço, mantenha o nome padrão ou insira um novo.
6. No campo Caminho de download, navegue até o local onde quer salvar a chave da conta de serviço.
Mantenha a chave em local seguro e nunca a marque no controle de origem.
7. Se sua API exigir, selecione os papéis que você quer adicionar à conta de serviço.
8. Clique em OK.


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.
9. Para acessar as APIs do 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".

No servidor de aplicativos local, esta seção aparece na guia Inicialização/conexão.

4. As variáveis de ambiente são inseridas automaticamente para você.
Caso esteja usando o padrão do App Engine e tenha configurações de execução locais, a caixa de diálogo de confirmação exibirá essas configurações de execução. Selecione as configurações a que quer adicionar essas variáveis de ambiente e clique em Adicionar variáveis.

Como receber suporte

Para enviar feedback, relate problemas no GitHub ou faça uma pergunta no Stack Overflow.