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 da 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.


    É apresentada 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)
	}
}