Antes de empezar (v3)

Configurar

Para registrar tu proyecto de Google Cloud en el registro de datos, sigue estos pasos:

  1. Ve a la consola de GCP.
    Si aún no tienes configurado un proyecto de Google Cloud, debes crear un proyecto.
  2. Ve a la configuración de tu proyecto de Cloud Talent Solution en el panel de control de GCP. Para ver la navegación, haz clic en el icono de menú de la esquina superior izquierda y desplázate hacia abajo para seleccionar Talent Solution en Inteligencia artificial.

    Seleccione su proyecto en el menú desplegable.
  3. Si aún no tiene una cuenta de facturación asociada a este proyecto de Google Cloud, se le pedirá que configure una y que la vincule a este proyecto de Google Cloud. Ten en cuenta que solo puede vincularlos la persona que sea propietaria del proyecto de Google Cloud y de la cuenta de facturación.
    1. Haz clic en Habilitar facturación.

      Aparecerá el cuadro de diálogo Habilitar la facturación del proyecto.
    2. Haz clic en CREAR CUENTA DE FACTURACIÓN. Consulta el artículo Crear, modificar o cerrar tu cuenta de facturación.
  4. Habilitar API
    Haz clic en HABILITAR.

  5. Aparecerá la página del panel de control.
    Haz clic en la pestaña REGISTRO DE DATOS.

  6. Aparecerá la página de activación del registro de datos. Si aceptas los términos descritos en esta página, podrás usar las distintas funciones de la API. Si no aceptas estos términos, solo podrás usar solicitudes de la API de eliminación.

    Haz clic en HABILITAR.

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


    Aparecerá la vista Conectar cuentas de servicio.

  8. Conectar cuentas de servicio
    Si ya has creado cuentas de servicio para tu proyecto de Google Cloud, verás una lista de ellas. De lo contrario, haz clic en GESTIONAR CUENTAS DE SERVICIO. Para obtener instrucciones, consulta el artículo Crear una cuenta de servicio.



    Al crear la cuenta de servicio, marca también la casilla Proporcionar una nueva clave privada. Se descargará automáticamente un nuevo archivo de credenciales JSON. Guarda este archivo en una ubicación específica del servidor y sigue las instrucciones para definir la variable de entorno GOOGLE_APPLICATION_CREDENTIALS de forma que apunte a este archivo. Este paso es fundamental para autenticar las solicitudes a Cloud Talent Solution.

  9. Después de crear la cuenta de servicio, vuelve a la pestaña de navegación de la izquierda de Cloud Talent Solution. Ahora aparece la cuenta de servicio que has creado. Haz clic en CONECTAR para vincular esta cuenta a Cloud Talent Solution.

  10. La cuenta ya está conectada.
    Haz clic en HECHO para continuar.

  11. Ahora ya puedes empezar a integrar Cloud Talent Solution en tu sistema.

  12. Define el ID de 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"
  13. A continuación, consulta la guía de inicio rápido Crear empresas y empleos para empezar a integrar Cloud Talent Solution.

Instalar la biblioteca de cliente

Java

Para obtener más información sobre cómo instalar y crear un cliente de Cloud Talent Solution, consulta las bibliotecas de cliente de Cloud Talent Solution.

Si usas Maven, añade este fragmento de código al archivo pom.xml:

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

Python

Para obtener más información sobre cómo instalar y crear un cliente de Cloud Talent Solution, consulta las bibliotecas de cliente de Cloud Talent Solution. 

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

Node.js

Para obtener más información sobre cómo instalar y crear un cliente de Cloud Talent Solution, consulta las bibliotecas de cliente de Cloud Talent Solution. 

npm install googleapis

Go

Para obtener más información sobre cómo instalar y crear un cliente de Cloud Talent Solution, consulta las bibliotecas de cliente de Cloud Talent Solution. 

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

Hacer una solicitud

Java

Para obtener más información sobre cómo instalar y crear un cliente de Cloud Talent Solution, consulta las bibliotecas de 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

Para obtener más información sobre cómo instalar y crear un cliente de Cloud Talent Solution, consulta las bibliotecas de 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

Para obtener más información sobre cómo instalar y crear un cliente de Cloud Talent Solution, consulta las bibliotecas de 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)
	}
}