O Explorador de APIs é uma excelente forma de experimentar a Cloud Talent Solution. O Explorador apresenta um formulário que mostra os parâmetros de cada método. Preencha o formulário, execute a chamada API e veja os resultados. Clique no botão seguinte para ver o Explorador de APIs.
O Explorador de APIs é apresentado:
Autorize o Explorador de APIs
Primeiro, certifique-se de que tem as autorizações de "Editor do projeto do Cloud Talent Solution" , conforme descrito na página Gestão de identidade e acesso (IAM). Pode fazê-lo atualizando a secção "IAM e administração" do seu Google Cloud projeto (consulte a secção Antes de começar para ver instruções sobre como criar um novo projeto).
Clique em Autorizar pedidos através do OAuth 2.0. É apresentado o formulário Selecionar âmbitos do OAuth 2.0:
Selecione ambos os itens de âmbito na lista, conforme indicado na captura de ecrã acima, e clique em Autorizar.
O formulário do Explorador de APIs para a Cloud Talent Solution é apresentado com uma lista de métodos da API.
Escolher um método
Escolha o método que quer usar para ligar. Este tutorial mostra como listar as empresas que criou. Se não existirem empresas criadas, a resposta é um conjunto de resultados vazio. Para criar uma nova empresa, siga os procedimentos mais gerais indicados abaixo, enquanto procura a documentação de referência para receber orientações sobre os dados necessários para cada chamada da API.
Para apresentar uma lista das empresas que criou, clique em jobs.projects.companies.list, conforme mostrado abaixo:
É apresentado o formulário do método companies.list
Preencha os parâmetros
Preencha os seguintes campos no formulário:
- parent:
projects/{project-id} - pageSize:
20
Substitua o ID do projeto por {project_id}, mas copie todos os outros campos sem alterações.
Nota: estes campos contêm valores de string, mas não coloque aspas à volta dos valores. Se um valor tiver strings internas, como filter, use aspas duplas à volta das strings internas.
Execute o método
Clique no botão Executar. Se receber uma mensagem de erro, verifique se introduziu as informações conforme mostrado acima. Faça as alterações necessárias no formulário e clique novamente em Executar. (Pode ter de clicar em Executar duas vezes). Se receber um conjunto de resultados vazio, significa que não existem empresas já criadas. Volte a tentar este tutorial com o método jobs.projects.companies.create para criar uma empresa.
Não hesite em explorar os métodos e os formulários da API por si.
Dica: depois de obter o resultado pretendido, adicione o URL do API Explorer aos favoritos. Quando quiser executar o método novamente, cole o URL no navegador. O formulário já está preenchido com os seus valores. Faça as alterações que quiser e, em seguida, volte a autorizar o Explorer e clique em Executar para executar o método.