Publicar e receber mensagens no Pub/Sub através da Google Cloud consola

Publicar e receber mensagens no Pub/Sub através da Google Cloud consola

Esta página mostra como realizar tarefas básicas no Pub/Sub através da Google Cloud consola.

---

Para seguir orientações passo a passo para esta tarefa diretamente na Google Cloud consola, clique em Orientar-me:

Visita guiada

---

Antes de começar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
Roles required to select or create a project
• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.
Go to project selector
Verify that billing is enabled for your Google Cloud project.
Enable the Pub/Sub API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.
Enable the API
Make sure that you have the following role or roles on the project: Pub/Sub Admin
Check for the roles
1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.

3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.
Grant the roles
1. In the Google Cloud console, go to the IAM page.

   Aceder ao IAM
2. Selecione o projeto.
3. Clique em Conceder acesso.

4. No campo Novos responsáveis, introduza o identificador do utilizador. Normalmente, este é o endereço de email de uma Conta Google.

5. Na lista Selecionar uma função, selecione uma função.
6. Para conceder funções adicionais, clique em Adicionar outra função e adicione cada função adicional.
7. Clique em Guardar.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Pub/Sub API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Make sure that you have the following role or roles on the project: Pub/Sub Admin

Check for the roles

1. In the Google Cloud console, go to the IAM page.

   Go to IAM
2. Select the project.

3. In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.

4. For all rows that specify or include you, check the Role column to see whether the list of roles includes the required roles.

Grant the roles

1. In the Google Cloud console, go to the IAM page.

   Aceder ao IAM
2. Selecione o projeto.
3. Clique em Conceder acesso.

4. No campo Novos responsáveis, introduza o identificador do utilizador. Normalmente, este é o endereço de email de uma Conta Google.

5. Na lista Selecionar uma função, selecione uma função.
6. Para conceder funções adicionais, clique em Adicionar outra função e adicione cada função adicional.
7. Clique em Guardar.

Crie um tópico

1. Na Google Cloud consola, aceda à página Pub/Sub.

   Aceda ao Pub/Sub

2. Na página Tópicos, clique em Criar tópico.

3. Na janela apresentada, introduza MyTopic no campo ID do tópico.

   Deixe os valores predefinidos para as opções restantes e, em seguida, clique em Criar.

   É apresentada a mensagem de êxito: A new topic and a new subscription have been successfully created.

   Acabou de criar um tópico denominado MyTopic e uma subscrição predefinida associada MyTopic-sub.

Adicione uma segunda subscrição

Para adicionar uma segunda subscrição ao tópico que acabou de criar, conclua estes passos:

1. Na Google Cloud consola, aceda à página Subscrições do Pub/Sub.

   Aceder a Subscrições

2. Na página Subscrições, clique em Criar subscrição.

3. Introduza MySub no campo ID da subscrição.

4. Em Selecionar um tópico do Cloud Pub/Sub, selecione o tópico MyTopic no menu pendente.

5. Deixe os valores predefinidos para as opções restantes.

6. Clique em Criar.

   É apresentada a mensagem de êxito: Subscription successfully added.

   A subscrição do MySub está agora associada ao tópico MyTopic. O Pub/Sub entrega todas as mensagens enviadas para MyTopic às subscrições MySub e MyTopic-sub.

Publicar uma mensagem no tópico

1. Na Google Cloud consola, aceda à página Tópicos do Pub/Sub.

   Aceda a Tópicos

2. Clique no tópico MyTopic.

3. Clique na página Tópicos e clique em MyTopic.

4. Na página MyTopic, clique no separador Mensagens.

5. Clique em Publicar mensagem.

6. Na janela Corpo da mensagem, introduza Hello World.

7. Clique em Publicar. Se a publicação for bem-sucedida, é apresentada uma mensagem na parte inferior da página com a indicação "Mensagem publicada".

Extraia as mensagens da subscrição

1. Na Google Cloud consola, aceda à página Subscrições do Pub/Sub.

   Aceder a Subscrições

2. No separador Mensagens, clique em Extrair.

Deverá ver a mensagem que acabou de publicar. A mensagem tem os dados Hello World e a hora em que foi publicada.

Quando usa a Google Cloud consola, uma obtenção individual para um volume de mensagens baixo pode, muitas vezes, devolver zero mensagens. Se não vir mensagens, clique em Extrair várias vezes para emitir vários pedidos de extração. Este não é um problema com as bibliotecas de cliente do Pub/Sub.

Limpar

Para evitar incorrer em cobranças na sua Google Cloud conta pelos recursos usados nesta página, siga estes passos.

Se já não precisar do tópico e da subscrição que criou, pode eliminá-los.

Para eliminar o tópico e a subscrição, conclua estes passos:

1. Aceda à página Tópicos.

2. Selecione a caixa de verificação junto a MyTopic e clique em Eliminar.

3. Conclua os passos na janela de confirmação para eliminar permanentemente o tópico.

Em alternativa, pode eliminar o projeto que criou.

O que se segue?

• Saiba mais sobre os conceitos do Pub/Sub abordados nesta página.

• Leia as noções básicas do serviço Pub/Sub.

• Trabalhe num exemplo ponto a ponto de um sistema Pub/Sub.

• Experimente outro início rápido do Pub/Sub que use bibliotecas cliente ou a CLI do Google Cloud.

• Saiba como criar tópicos e publicar mensagens.

• Escolha ou crie uma subscrição.

• Saiba mais acerca das APIs Pub/Sub.