Antes de começar (v3)

Configurar

Para inscrever o seu projeto do Google Cloud no registo de dados, siga estes passos:

  1. Aceda à GCP Console.
    Se ainda não tiver um projeto do Google Cloud configurado, tem de criar um projeto.
  2. Aceda às definições do projeto para a Cloud Talent Solution no painel de controlo da GCP. Para ver a navegação, clique no ícone de hambúrguer no canto superior esquerdo e desloque a página para baixo para selecionar Talent Solution em Inteligência artificial.

    Selecione o seu projeto no menu pendente.
  3. Se ainda não tiver uma conta de faturação associada a este projeto do Google Cloud, é-lhe pedido que configure primeiro uma conta de faturação e, em seguida, a associe a este projeto do Google Cloud. Tenha em atenção que apenas uma pessoa que seja proprietária do projeto do Google Cloud e proprietária da conta de faturação pode associá-los.
    1. Clique em Ativar faturação.

      É apresentada a caixa de diálogo Ativar faturação para o projeto.
    2. Clique em CRIAR CONTA DE FATURAÇÃO. Consulte o artigo Crie, modifique ou encerre a sua conta de faturação.
  4. Ative a API
    Clique em ATIVAR.

  5. É apresentada a página do painel de controlo.
    Clique no separador REGISTO DE DADOS.

  6. É apresentada a página de aceitação do registo de dados. A aceitação dos termos descritos nesta página permite-lhe usar as várias funcionalidades da API. Se não aceitar estes termos, só pode usar pedidos da API de eliminação.

    Clique em ATIVAR.

    É apresentada a página de confirmação.
  7. Clique em CONTINUAR na página de confirmação.


    Aparece a vista Associar contas de serviço.

  8. Associar contas de serviço
    Se já tiver contas de serviço criadas para o seu projeto do Google Cloud, é apresentada uma lista das mesmas. Caso contrário, clique em GERIR CONTAS DE SERVIÇO. Consulte o artigo Criar uma conta de serviço para ver instruções.



    Ao criar a conta de serviço, selecione também a caixa Fornecer uma nova chave privada. É transferido automaticamente um novo ficheiro de credenciais JSON. Armazene este ficheiro numa localização específica no servidor e siga as instruções para definir a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS de modo a apontar para este ficheiro. Este é um passo essencial para autenticar pedidos à Cloud Talent Solution.

  9. Depois de criar a conta de serviço, regresse ao separador de navegação à esquerda da Cloud Talent Solution. A conta de serviço que criou é apresentada. Clique em ASSOCIAR para associar esta conta ao Cloud Talent Solution.

  10. A conta está agora associada.
    Clique em CONCLUÍDO para continuar.

  11. Já pode começar a integrar a Cloud Talent Solution no seu sistema.

  12. Defina o ID do projeto para o ambiente.

    LINUX OU MACOS

    export GOOGLE_CLOUD_PROJECT="your-project-id"

    WINDOWS

    Com o PowerShell:

    $env:GOOGLE_CLOUD_PROJECT="your-project-id"

    Com a linha de comandos:

    set GOOGLE_CLOUD_PROJECT="your-project-id"
  13. Em seguida, aceda ao início rápido Crie empresas e empregos para começar a integrar a Cloud Talent Solution.

Instale a biblioteca cliente

Java

Para mais informações sobre a instalação e a criação de um cliente da Cloud Talent Solution, consulte as bibliotecas de cliente da Cloud Talent Solution.

Se estiver a usar o Maven, adicione o seguinte ao ficheiro pom.xml:

  <dependency>
      <groupId>com.google.apis</groupId>
      <artifactId>google-api-services-jobs</artifactId>
      <version>LATEST</version>
  </dependency>

Python

Para mais informações sobre a instalação e a criação de um cliente da Cloud Talent Solution, consulte as bibliotecas de cliente da Cloud Talent Solution. 

pip install --upgrade google-api-python-client

Node.js

Para mais informações sobre a instalação e a criação de um cliente da Cloud Talent Solution, consulte as bibliotecas de cliente da Cloud Talent Solution. 

npm install googleapis

Go

Para mais informações sobre a instalação e a criação de um cliente da Cloud Talent Solution, consulte as bibliotecas de cliente da Cloud Talent Solution. 

go get google.golang.org/api/jobs/v3

Fazer um pedido

Java

Para mais informações sobre a instalação e a criação de um cliente da Cloud Talent Solution, consulte as bibliotecas de cliente da Cloud Talent Solution. 


private static final JsonFactory JSON_FACTORY = new GsonFactory();
private static final NetHttpTransport NET_HTTP_TRANSPORT = new NetHttpTransport();
private static final String DEFAULT_PROJECT_ID =
    "projects/" + System.getenv("GOOGLE_CLOUD_PROJECT");

private static CloudTalentSolution talentSolutionClient =
    createTalentSolutionClient(generateCredential());

private static CloudTalentSolution createTalentSolutionClient(GoogleCredentials credential) {
  String url = "https://jobs.googleapis.com";

  HttpRequestInitializer requestInitializer =
      request -> {
        new HttpCredentialsAdapter(credential).initialize(request);
        request.setConnectTimeout(60000); // 1 minute connect timeout
        request.setReadTimeout(60000); // 1 minute read timeout
      };

  return new CloudTalentSolution.Builder(NET_HTTP_TRANSPORT, JSON_FACTORY, requestInitializer)
      .setApplicationName("JobServiceClientSamples")
      .setRootUrl(url)
      .build();
}

private static GoogleCredentials generateCredential() {
  try {
    // Credentials could be downloaded after creating service account
    // set the `GOOGLE_APPLICATION_CREDENTIALS` environment variable, for example:
    // export GOOGLE_APPLICATION_CREDENTIALS=/path/to/your/key.json
    return GoogleCredentials.getApplicationDefault()
        .createScoped(Collections.singleton(CloudTalentSolutionScopes.JOBS));
  } catch (Exception e) {
    System.out.println("Error in generating credential");
    throw new RuntimeException(e);
  }
}

public static CloudTalentSolution getTalentSolutionClient() {
  return talentSolutionClient;
}

public static void main(String... args) throws Exception {
  try {
    ListCompaniesResponse listCompaniesResponse =
        talentSolutionClient.projects().companies().list(DEFAULT_PROJECT_ID).execute();
    System.out.println("Request Id is " + listCompaniesResponse.getMetadata().getRequestId());
    if (listCompaniesResponse.getCompanies() != null) {
      for (Company company : listCompaniesResponse.getCompanies()) {
        System.out.println(company.getName());
      }
    }
  } catch (IOException e) {
    System.out.println("Got exception while listing companies");
    throw e;
  }
}

Python

Para mais informações sobre a instalação e a criação de um cliente da Cloud Talent Solution, consulte as bibliotecas de cliente da Cloud Talent Solution. 

import os

from googleapiclient.discovery import build
from googleapiclient.errors import Error

client_service = build("jobs", "v3")


def run_sample():
    try:
        project_id = "projects/" + os.environ["GOOGLE_CLOUD_PROJECT"]
        response = (
            client_service.projects().companies().list(parent=project_id).execute()
        )
        print("Request Id: %s" % response.get("metadata").get("requestId"))
        print("Companies:")
        if response.get("companies") is not None:
            for company in response.get("companies"):
                print("%s" % company.get("name"))
        print("")

    except Error as e:
        print("Got exception while listing companies")
        raise e


if __name__ == "__main__":
    run_sample()

Go

Para mais informações sobre a instalação e a criação de um cliente da Cloud Talent Solution, consulte as bibliotecas de cliente da Cloud Talent Solution. 


// Command quickstart is an example of using the Google Cloud Talent Solution API.
package main

import (
	"context"
	"fmt"
	"log"
	"os"

	"golang.org/x/oauth2/google"
	talent "google.golang.org/api/jobs/v3"
)

func main() {
	projectID := os.Getenv("GOOGLE_CLOUD_PROJECT")
	parent := fmt.Sprintf("projects/%s", projectID)

	// Authorize the client using Application Default Credentials.
	// See https://g.co/dv/identity/protocols/application-default-credentials
	ctx := context.Background()
	client, err := google.DefaultClient(ctx, talent.CloudPlatformScope)
	if err != nil {
		log.Fatal(err)
	}

	// Create the jobs service client.
	ctsService, err := talent.New(client)
	if err != nil {
		log.Fatal(err)
	}

	// Make the RPC call.
	response, err := ctsService.Projects.Companies.List(parent).Do()
	if err != nil {
		log.Fatalf("Failed to list Companies: %v", err)
	}

	// Print the request id.
	fmt.Printf("Request ID: %q\n", response.Metadata.RequestId)

	// Print the returned companies.
	for _, company := range response.Companies {
		fmt.Printf("Company: %q\n", company.Name)
	}
}