Antes de começar (v3)

Configurar

Para inscrever o projeto do Google Cloud Platform (projeto do GCP) na geração de registros de dados, siga estes passos:

1. Acesse o Console do GCP.
   Se ainda não tiver um projeto do Google Cloud configurado, você precisará criar um projeto.
2. Acesse as configurações do projeto da Cloud Talent Solution no painel do GCP. Para visualizar a navegação, clique no ícone de três traços no canto superior esquerdo e role a tela para selecionar Talent Solution em Inteligência artificial.
   
   Selecione o projeto na lista suspensa.
3. Se ainda não tiver uma conta de faturamento associada ao projeto do Google Cloud, você receberá uma mensagem para configurar uma conta desse tipo e vinculá-la a esse projeto. Somente o proprietário do projeto do Google Cloud e o proprietário da conta de faturamento podem vinculá-la.
   1. Clique em Ativar faturamento.
      
      A caixa de diálogo Ativar faturamento do projeto é exibida.
      
   2. Clique em CRIAR CONTA DE FATURAMENTO. Consulte Criar, modificar ou encerrar a conta de faturamento.
4. Ativar API
   Clique em ATIVAR.
   
   
5. A página do painel é exibida.
   Clique na guia GERAÇÃO DE REGISTROS DE DADOS.
   
   
6. A página para ativar a geração de registros de dados é exibida. Aceite os termos descritos nessa página para usar os recursos da API. Se não aceitar esses termos, você só poderá usar solicitações da API de exclusão.
   
   Clique em ATIVAR.
   
   A página de confirmação é exibida.
7. Clique em CONTINUAR na página de confirmação.
   
   
   A visualização Conectar contas de serviço é exibida.
   
   Observação:o Cloud Talent Solution só permite autenticar solicitações da API por meio das chaves da conta de serviço e do OAuth2.0.
   
   
8. Conectar contas de serviço
   Se já tiver contas de serviço criadas para o projeto do Google Cloud, você verá uma lista delas aqui. Caso contrário, clique em GERENCIAR CONTAS DE SERVIÇO. Consulte Como criar uma conta de serviço para ver instruções.
   
   
   Observação: verifique se você definiu as permissões apropriadas para a conta de serviço (por exemplo, "Administrador do Cloud Talent Solution").
   
   
   Ao criar a conta de serviço, marque também a caixa Fornecer uma nova chave privada. Será feito o download automático de um novo arquivo de credencial JSON. Armazene esse arquivo em um local específico no servidor e instructions para definir que a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS aponte para esse arquivo. Essa é uma etapa essencial para autenticar solicitações para a Cloud Talent Solution.
   
   
9. Depois de criar a conta de serviço, volte para a guia de navegação esquerda do Cloud Talent Solution. A conta de serviço criada será exibida agora. Clique em CONECTAR para vincular essa conta ao Cloud Talent Solution.
   
   
10. A conta já está conectada.
    Clique em CONCLUÍDO para continuar.
    
    
11. Já está tudo pronto para começar a integrar o Cloud Talent Solution ao sistema.
    
    
12. Defina o código 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 o prompt de comando:

    set GOOGLE_CLOUD_PROJECT="your-project-id"

13. Em seguida, acesse o início rápido Criar empresas e vagas para começar a integrar a Cloud Talent Solution.

Instalar biblioteca de cliente

Java

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

Se você usa Maven, adicione este código ao arquivo pom.xml:

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

Observação:no momento, as bibliotecas de cliente do Google Cloud para Java não são compatíveis com Android.

Python

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

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

Node.js

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

npm install --save googleapis

Go

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

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

Fazer uma solicitação

Java

Para mais informações sobre a instalação e criação de um cliente do Cloud Talent Solution, consulte Bibliotecas de cliente do 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 criação de um cliente do Cloud Talent Solution, consulte Bibliotecas de cliente do 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 criação de um cliente do Cloud Talent Solution, consulte Bibliotecas de cliente do 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)
	}
}