Gerenciar conjuntos de dados

Gerencie conjuntos de dados de tradução adaptativa usando a API Cloud Translation. Você pode listar conjuntos de dados, listar arquivos usados por um conjunto de dados, excluir todas as entradas de um determinado arquivo ou excluir conjuntos de dados.

Listar conjuntos de dados

Confira uma lista de todos os conjuntos de dados de tradução adaptável no seu projeto.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

PROJECT_NUMBER_OR_ID: o ID numérico ou alfanumérico do projeto do Google Cloud
LOCATION: a região em que o conjunto de dados de origem está localizado, como us-central1.

Método HTTP e URL:

GET https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION/adaptiveMtDatasets

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_NUMBER_OR_ID" \
     "https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION/adaptiveMtDatasets"

PowerShell (Windows)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER_OR_ID" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION/adaptiveMtDatasets" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "adaptiveMtDatasets": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/adaptiveMtDatasets/DATASET_ID",
      "displayName": "DISPLAY_NAME",
      "sourceLanguageCode": "SOURCE_LANGUAGE",
      "targetLanguageCode": "TARGET_LANGUAGE"
    }
  ]
}

Java

Antes de testar esta amostra, siga as instruções de configuração do Java no Guia de início rápido do Cloud Translation: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Cloud Translation em Java.

Para autenticar no Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.

/** Lists all AdaptiveMtDatasets in a project. */
private static void listAdaptiveMtDatasets(
    TranslationServiceClient translationServiceClient, String projectId) {
  ListAdaptiveMtDatasetsRequest listAdaptiveMtDatasetsRequest =
      ListAdaptiveMtDatasetsRequest.newBuilder()
          .setParent(LocationName.of(projectId, "LOCATION").toString())
          .build();
  ListAdaptiveMtDatasetsPagedResponse response =
      translationServiceClient.listAdaptiveMtDatasets(listAdaptiveMtDatasetsRequest);

  System.out.println("Listing datasets:");
  for (AdaptiveMtDataset dataset : response.iterateAll()) {
    System.out.println(dataset);
  }
}

Node.js

Antes de testar esta amostra, siga as instruções de configuração do Node.js no Guia de início rápido do Cloud Translation: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Cloud Translation em Node.js.

Para autenticar no Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.

async function listAdaptiveMtDatasets() {
  const request = {
    parent: `projects/${projectId}/locations/${location}`
  } const [response] = await translationClient.listAdaptiveMtDatasets(request)
  console.log('Listing datasets')
  console.log(response)
}

Python

Antes de testar esta amostra, siga as instruções de configuração do Python no Guia de início rápido do Cloud Translation: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API Cloud Translation em Python.

Para autenticar no Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.

def list_adaptive_mt_datasets():
  # Create a client
  client = translate.TranslationServiceClient()
  # Initialize the request
  request = translate.ListAdaptiveMtDatasetsRequest(
      parent="projects/PROJECT_ID/locations/LOCATION",
  )
  # Make the request
  response = client.list_adaptive_mt_datasets(request)
  # Handle the response
  print(response)

Listar arquivos do conjunto de dados

Liste os arquivos no conjunto de dados para saber quais foram usados para preencher o conjunto de dados. O Cloud Translation gera os nomes dos arquivos e o número de pares de frases (entradas) importados de cada arquivo.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

PROJECT_NUMBER_OR_ID: o ID numérico ou alfanumérico do projeto do Google Cloud
LOCATION: a região em que o conjunto de dados está localizado, como us-central1.
DATASET_ID: o identificador exclusivo do conjunto de dados que contém os arquivos a serem listados.

Método HTTP e URL:

GET https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION/adaptiveMtDatasets/DATASET_ID/adaptiveMtFiles

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_NUMBER_OR_ID" \
     "https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION/adaptiveMtDatasets/DATASET_ID/adaptiveMtFiles"

PowerShell (Windows)

execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER_OR_ID" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION/adaptiveMtDatasets/DATASET_ID/adaptiveMtFiles" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "adaptiveMtFile": [
    {
      "name": "FILE_NAME",
      "displayName": "DESCRIPTIVE_NAME",
      "entryCount": TOTAL_ENTRIES
    }
  ]
}

Java

Para autenticar no Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.

/** Lists all AdaptiveMtFiles in a dataset. */
private static void listAdaptiveMtFiles(
    TranslationServiceClient translationServiceClient, String projectId, String datasetId) {
  String adaptiveMtDatasetName =
      String.format(
          "projects/%s/locations/LOCATION/adaptiveMtDatasets/%s", projectId, datasetId);
  TranslationServiceClient.ListAdaptiveMtFilesPagedResponse response =
      translationServiceClient.listAdaptiveMtFiles(adaptiveMtDatasetName);

  System.out.println("Listing dataset files:");
  for (AdaptiveMtFile file : response.iterateAll()) {
    System.out.println(file.toString());
  }
}

Node.js

Para autenticar no Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.

async function listAdaptiveMtFiles() {
  const request = {
    parent: `projects/${projectId}/locations/${location}/adaptiveMtDatasets/${
        adaptiveMtDatasetName}`,
  } const [response] = await translationClient.listAdaptiveMtFiles(request)
  console.log('Listing files')
  console.log(response)
}

Python

Para autenticar no Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.

def list_adaptive_mt_files():
  # Create a client
  client = translate.TranslationServiceClient()
  # Initialize the request
  request = translate.ListAdaptiveMtFilesRequest(
      parent="projects/PROJECT_ID/locations/LOCATION/adaptiveMtDatasets/DATASET_ID"
  )
  # Make the request
  response = client.list_adaptive_mt_files(request)
  # Handle the response
  print(response)

Excluir arquivo do conjunto de dados

Excluir entradas de um arquivo específico em um determinado conjunto de dados. Você precisa fornecer o ID do arquivo, que faz parte do nome do recurso do arquivo retornado do método de listagem de arquivos.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

PROJECT_NUMBER_OR_ID: o ID numérico ou alfanumérico do projeto do Google Cloud
LOCATION: a região em que o conjunto de dados está localizado, como us-central1.
DATASET_ID: o identificador exclusivo do conjunto de dados que contém os arquivos a serem listados.
FILE_ID: o identificador exclusivo do arquivo a ser excluído, que é fornecido quando você lista arquivos de conjunto de dados.

Método HTTP e URL:

DELETE https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION/adaptiveMtDatasets/DATASET_ID/adaptiveMtFiles/FILE_ID

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

execute o seguinte comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_NUMBER_OR_ID" \
     "https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION/adaptiveMtDatasets/DATASET_ID/adaptiveMtFiles/FILE_ID"

PowerShell (Windows)

execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER_OR_ID" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION/adaptiveMtDatasets/DATASET_ID/adaptiveMtFiles/FILE_ID" | Select-Object -Expand Content

Você receberá um código de status bem-sucedido (2xx) e uma resposta vazia.

Java

Para autenticar no Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.

/** Deletes an AdaptiveMtFile. */
private static void deleteAdaptiveMtFile(
    TranslationServiceClient translationServiceClient, String fileId) {
  System.out.println("Deleting AdaptiveMtFile");
  translationServiceClient.deleteAdaptiveMtFile(fileId);
}

Node.js

Para autenticar no Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.

async function deleteAdaptiveMtFile() {
  const request = {
    name: `projects/${projectId}/locations/${location}/adaptiveMtDatasets/${
        adaptiveMtDatasetName}/adaptiveMtFiles/${adaptive_mt_file_id}`,
  } const [response] = await translationClient.deleteAdaptiveMtFile(request)
  console.log('Deleting file')
  console.log(response)
}

Python

Para autenticar no Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.

def delete_adaptive_mt_file():
  # Create a client
  client = translate.TranslationServiceClient()
  # Initialize the request
  request = translate.DeleteAdaptiveMtFileRequest(
      name="projects/PROJECT_ID/locations/LOCATION/adaptiveMtDatasets/DATASET_ID/adaptiveMtFiles/FILE_ID"
  )
  # Make the request
  response = client.delete_adaptive_mt_file(request)
  # Handle the response
  print(response)

Excluir conjuntos de dados

Exclua um conjunto de dados para remover todos os respectivos dados.

REST

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

PROJECT_NUMBER_OR_ID: o ID numérico ou alfanumérico do projeto do Google Cloud
LOCATION: a região em que o conjunto de dados de origem está localizado, como us-central1.
DATASET_ID: o identificador exclusivo do conjunto de dados a ser excluído.

Método HTTP e URL:

DELETE https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION/adaptiveMtDatasets/DATASET_ID

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

execute o seguinte comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_NUMBER_OR_ID" \
     "https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION/adaptiveMtDatasets/DATASET_ID"

PowerShell (Windows)

execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER_OR_ID" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://translation.googleapis.com/v3/projects/PROJECT_ID/locations/LOCATION/adaptiveMtDatasets/DATASET_ID" | Select-Object -Expand Content

Você receberá um código de status bem-sucedido (2xx) e uma resposta vazia.

Java

Para autenticar no Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.

/** Deletes an AdaptiveMtDataset. */
private static void deleteAdaptiveMtDataset(
    TranslationServiceClient translationServiceClient, String projectId, String datasetId) {
  System.out.println("Deleting AdaptiveMtDataset");
  String adaptiveMtDatasetName =
      String.format(
          "projects/%s/locations/LOCATION/adaptiveMtDatasets/%s", projectId, datasetId);
  translationServiceClient.deleteAdaptiveMtDataset(adaptiveMtDatasetName);
}

public static void main(String[] args) {

  String projectName = "PROJECT_NAME";
  String datasetId = "java-dataset-test";
  String gcsUri = "gs://SOURCE_LOCATION/FILE.tsv";

  try (TranslationServiceClient translationServiceClient = TranslationServiceClient.create()) {

    createAdaptiveMtDataset(translationServiceClient, projectName, datasetId);
    listAdaptiveMtDatasets(translationServiceClient, projectName);
    getAdaptiveMtDataset(translationServiceClient, projectName, datasetId);

    String fileId =
        importAdaptiveMtFile(translationServiceClient, projectName, datasetId, gcsUri);

    listAdaptiveMtFiles(translationServiceClient, projectName, datasetId);
    getAdaptiveMtFile(translationServiceClient, fileId);

    adaptiveMtTranslate(translationServiceClient, projectName, datasetId);

    deleteAdaptiveMtFile(translationServiceClient, fileId);
    deleteAdaptiveMtDataset(translationServiceClient, projectName, datasetId);
  } catch (java.io.IOException e) {
    System.out.println(e.toString());
  }
}

Node.js

Para autenticar no Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.

async function deleteAdaptiveMtDataset() {
  const request = {
    name: `projects/${projectId}/locations/${location}/adaptiveMtDatasets/${
        adaptiveMtDatasetName}`
  } await translationClient.deleteAdaptiveMtDataset(request)
  console.log('Deleted dataset')
}

Python

Para autenticar no Cloud Translation, configure o Application Default Credentials. Para mais informações, consulte Configurar a autenticação para um ambiente de desenvolvimento local.

def delete_adaptive_mt_dataset():
  # Create a client
  client = translate.TranslationServiceClient()
  # Initialize the request
  request = translate.DeleteAdaptiveMtDatasetRequest(
      name="projects/PROJECT_ID/locations/LOCATION/adaptiveMtDatasets/DATASET_ID"
  )
  # Make the request
  response = client.delete_adaptive_mt_dataset(request)
  # Handle the response
  print(response)