Antes de comenzar (v3)

Configurar

Para inscribir tu proyecto de Google Cloud Platform (proyecto de GCP) en el registro de datos, sigue estos pasos:

Ve a GCP Console.
Si todavía no tienes configurado un proyecto de Google Cloud, debes crear uno.
Ve a la configuración de Cloud Talent Solution del proyecto en el panel de GCP. Para ver la navegación, haz clic en el ícono de tres líneas horizontales que se encuentra en la esquina superior izquierda, desplázate hacia abajo y selecciona Talent Solution en Artificial Intelligence (Inteligencia artificial).

Selecciona tu proyecto en el menú desplegable.
Si todavía no tienes una cuenta de facturación asociada a este proyecto de Google Cloud, se te solicitará que configures una y la vincules al proyecto. Ten en cuenta que solo el propietario del proyecto de Google Cloud y el propietario de la cuenta de facturación pueden vincularlos.
1. Haz clic en Habilitar facturación.
  
  Aparecerá el cuadro de diálogo Habilitar la facturación para el proyecto.
2. Haz clic en CREAR CUENTA DE FACTURACIÓN. Consulta Crea, modifica o cierra tu cuenta de facturación.
Habilitar la API
Haz clic en HABILITAR.
Aparecerá la página del panel.
Haz clic en la pestaña REGISTRO DE DATOS.
Aparecerá la página de aceptación del registro de datos. Acepta los términos que se describen en esta página para usar las diversas funciones de la API. Si no los aceptas, solo podrás usar las solicitudes a la API de eliminación.

Haz clic en HABILITAR.

Aparecerá la página de confirmación.
En la página de confirmación, haz clic en CONTINUAR.

Aparecerá la vista Conectar cuentas de servicios.
Nota: Cloud Talent Solution solo permite la autenticación de las solicitudes a la API mediante claves de cuentas de servicios y OAuth 2.0.
Conecta las cuentas de servicio
Si ya creaste cuentas de servicios para tu proyecto de Google Cloud, verás una lista de ellas aquí. En caso contrario, haz clic en MANAGE SERVICE ACCOUNTS (ADMINISTRAR CUENTAS DE SERVICIOS). Consulta Creaa una cuenta de servicio para obtener instrucciones.

Nota: Asegúrate de configurar los permisos adecuados para la cuenta de servicio (por ejemplo, Administrador de Cloud Talent Solution).

Cuando crees la cuenta de servicio, marca también la casilla Proporcionar una nueva clave privada. Se descargará un archivo de credencial JSON nuevo de manera automática. Almacena el archivo en una ubicación específica del servidor y sigue las instructions para configurar la variable del entorno GOOGLE_APPLICATION_CREDENTIALS a fin de que apunte a este archivo. Este es un paso fundamental para autenticar las solicitudes a Cloud Talent Solution.
Después de crear la cuenta de servicio, regresa a la pestaña Cloud Talent Solution del menú de navegación izquierdo. Aparecerá la cuenta de servicio que creaste. Haz clic en CONECTAR para vincularla a Cloud Talent Solution.
La cuenta ahora está conectada.
Haz clic en LISTO para continuar.
Ya está todo listo para que comiences a integrar Cloud Talent Solution a tu sistema.

Configura tu ID del proyecto en el entorno.

LINUX O MACOS

export GOOGLE_CLOUD_PROJECT="your-project-id"

WINDOWS

Con PowerShell:

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

Con el símbolo del sistema:

set GOOGLE_CLOUD_PROJECT="your-project-id"

A continuación, ve a la guía de inicio rápido Crea empresas y trabajos para comenzar la integración de Cloud Talent Solution.

Instala la biblioteca cliente

Java

Consulta Bibliotecas cliente de Cloud Talent Solution para obtener más información sobre cómo instalar y crear un cliente de Cloud Talent Solution.

Si usas Maven, agrega esto a tu archivo pom.xml:

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

Python

Consulta Bibliotecas cliente de Cloud Talent Solution para obtener más información sobre cómo instalar y crear un cliente de Cloud Talent Solution.

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

Node.js

Consulta Bibliotecas cliente de Cloud Talent Solution para obtener más información sobre cómo instalar y crear un cliente de Cloud Talent Solution.

npm install --save googleapis

Go

Consulta Bibliotecas cliente de Cloud Talent Solution para obtener más información sobre cómo instalar y crear un cliente de Cloud Talent Solution.

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

Haz una solicitud

Java

Consulta Bibliotecas cliente de Cloud Talent Solution para obtener más información sobre cómo instalar y crear un cliente de 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

Consulta Bibliotecas cliente de Cloud Talent Solution para obtener más información sobre cómo instalar y crear un cliente de 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

Consulta Bibliotecas cliente de Cloud Talent Solution para obtener más información sobre cómo instalar y crear un cliente de 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)
	}
}