Acceder a datos públicos

Algunos datos almacenados en Cloud Storage están configurados para que cualquier persona pueda leerlos en cualquier momento. Se puede acceder a estos datos públicos de varias formas, en función de cómo quieras trabajar con ellos.

Enlace de la API

Nota: Para acceder a este enlace, no es necesario autenticarse. Por ejemplo, se puede usar como enlace en una página web o para descargar con una herramienta de línea de comandos como cURL.

1. Obtener el nombre del objeto público y el segmento que lo almacena.

2. Usa el siguiente URI para acceder a un objeto del segmento:

   https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME

Por ejemplo, el bucket público de Google gcp-public-data-landsat contiene el conjunto de datos público de Landsat. Puedes crear un enlace al objeto compartido públicamente LC08/01/001/003/LC08_L1GT_001003_20140812_20170420_01_T2/LC08_L1GT_001003_20140812_20170420_01_T2_B3.TIF con el enlace:

https://storage.googleapis.com/gcp-public-data-landsat/LC08/01/001/003/LC08_L1GT_001003_20140812_20170420_01_T2/LC08_L1GT_001003_20140812_20170420_01_T2_B3.TIF

Consola

Nota: Para acceder a datos públicos con la Google Cloud consola, debes iniciar sesión con una cuenta de usuario. El método descrito en la pestaña Enlace de la API ofrece la forma más general de acceder a objetos públicos individuales. El método descrito en la pestaña Línea de comandos es la forma más eficiente de acceder a colecciones de datos.

1. Obtener el nombre del objeto público y el segmento que lo almacena.

2. Con un navegador web, accede al objeto con el siguiente URI (se te pedirá que inicies sesión si aún no lo has hecho):

   https://console.cloud.google.com/storage/browser/_details/BUCKET_NAME/OBJECT_NAME

3. Si el público tiene permiso para mostrar el contenido del segmento, puedes mostrar todos los objetos del segmento con el siguiente URI:

   https://console.cloud.google.com/storage/browser/BUCKET_NAME

Por ejemplo, el bucket público de Google gcp-public-data-landsat contiene el conjunto de datos público de Landsat. Puede acceder al segmento con:

https://console.cloud.google.com/storage/browser/gcp-public-data-landsat

Línea de comandos

Nota: Para acceder a datos públicos con gcloud CLI no es necesario autenticarse. Esta herramienta es adecuada para acceder de forma general a los segmentos que contienen datos públicos que se pueden enumerar públicamente.

1. Si no tienes la CLI de gcloud, sigue estas instrucciones para instalarla.

   • Cuando instales la CLI de gcloud, si no quieres autenticarte, omite el paso de ejecutar el comando gcloud init y, en su lugar, ejecuta el siguiente comando:

     gcloud config set auth/disable_credentials True

2. Obtener el nombre del objeto público y el segmento que lo almacena.

3. Si se concede permiso para enumerar el contenido del contenedor al público, puedes enumerar algunos o todos los objetos que contiene mediante el comando ls.

   Por ejemplo, el bucket público de Google gcp-public-data-landsat contiene el conjunto de datos público de Landsat. Puedes enumerar los objetos con el prefijo LC08/01/001/003/LC con el siguiente comando:

   gcloud storage ls --recursive gs://gcp-public-data-landsat/LC08/01/001/003/LC*

   Nota: Los shells (como bash y zsh) pueden intentar expandir comodines antes de pasar los argumentos a la CLI de gcloud. Para evitar estos problemas, rodea la expresión con comodines con comillas simples (en Linux) o comillas dobles (en Windows). Para obtener más información, consulta el artículo Comportamiento potencialmente sorprendente al usar comodines.

4. Descarga objetos públicos específicos incluidos en el segmento mediante el comando cp.

   Por ejemplo, el siguiente comando descarga un archivo del bucket gcp-public-data-landsat en tu directorio local:

   gcloud storage cp gs://gcp-public-data-landsat/LC08/01/001/003/LC08_L1GT_001003_20140812_20170420_01_T2/LC08_L1GT_001003_20140812_20170420_01_T2_B3.TIF .

Bibliotecas de cliente

C++

Para obtener más información, consulta la documentación de referencia de la API C++ de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

namespace gcs = ::google::cloud::storage;
[](std::string const& bucket_name, std::string const& object_name) {
  // Create a client that does not authenticate with the server.
  auto client = gcs::Client{
      google::cloud::Options{}.set<google::cloud::UnifiedCredentialsOption>(
          google::cloud::MakeInsecureCredentials())};

  // Read an object, the object must have been made public.
  gcs::ObjectReadStream stream = client.ReadObject(bucket_name, object_name);

  int count = 0;
  std::string line;
  while (std::getline(stream, line, '\n')) {
    ++count;
  }
  if (stream.bad()) throw google::cloud::Status(stream.status());
  std::cout << "The object has " << count << " lines\n";
}

C#

Para obtener más información, consulta la documentación de referencia de la API C# de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

using Google.Cloud.Storage.V1;
using System;
using System.IO;

public class DownloadPublicFileSample
{
    public string DownloadPublicFile(
        string bucketName = "your-bucket-name",
        string objectName = "your-object-name",
        string localPath = "path/to/download/object/to")
    {
        var storage = StorageClient.CreateUnauthenticated();

        using var outputFile = File.OpenWrite(localPath);
        storage.DownloadObject(bucketName, objectName, outputFile);

        Console.WriteLine($"Downloaded public file {objectName} from bucket {bucketName} to {localPath}.");
        return localPath;
    }
}

Go

Para obtener más información, consulta la documentación de referencia de la API Go de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

import (
	"context"
	"fmt"
	"io"
	"time"

	"cloud.google.com/go/storage"
	"google.golang.org/api/option"
)

// downloadPublicFile downloads a public object.
func downloadPublicFile(w io.Writer, bucket, object string) ([]byte, error) {
	// bucket := "bucket-name"
	// object := "object-name"
	ctx := context.Background()
	// Create a client that does not authenticate with the server.
	client, err := storage.NewClient(ctx, option.WithoutAuthentication())
	if err != nil {
		return nil, fmt.Errorf("storage.NewClient: %w", err)
	}
	defer client.Close()

	ctx, cancel := context.WithTimeout(ctx, time.Second*50)
	defer cancel()

	rc, err := client.Bucket(bucket).Object(object).NewReader(ctx)
	if err != nil {
		return nil, fmt.Errorf("Object(%q).NewReader: %w", object, err)
	}
	defer rc.Close()

	data, err := io.ReadAll(rc)
	if err != nil {
		return nil, fmt.Errorf("io.ReadAll: %w", err)
	}
	fmt.Fprintf(w, "Blob %v downloaded.\n", object)
	return data, nil
}

Java

Para obtener más información, consulta la documentación de referencia de la API Java de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

import com.google.cloud.storage.BlobId;
import com.google.cloud.storage.Storage;
import com.google.cloud.storage.StorageOptions;
import java.nio.file.Path;

public class DownloadPublicObject {
  public static void downloadPublicObject(
      String bucketName, String publicObjectName, Path destFilePath) {
    // The name of the bucket to access
    // String bucketName = "my-bucket";

    // The name of the remote public file to download
    // String publicObjectName = "publicfile.txt";

    // The path to which the file should be downloaded
    // Path destFilePath = Paths.get("/local/path/to/file.txt");

    // Instantiate an anonymous Google Cloud Storage client, which can only access public files
    Storage storage = StorageOptions.getUnauthenticatedInstance().getService();

    storage.downloadTo(BlobId.of(bucketName, publicObjectName), destFilePath);

    System.out.println(
        "Downloaded public object "
            + publicObjectName
            + " from bucket name "
            + bucketName
            + " to "
            + destFilePath);
  }
}

Node.js

Para obtener más información, consulta la documentación de referencia de la API Node.js de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

/**
 * TODO(developer): Uncomment the following lines before running the sample.
 */
// The ID of your GCS bucket
// const bucketName = 'your-unique-bucket-name';

// The ID of your GCS file
// const srcFilename = 'your-file-name';

// The path to which the file should be downloaded
// const destFileName = '/local/path/to/file.txt';

// Imports the Google Cloud client library
const {Storage} = require('@google-cloud/storage');

// Creates a client
const storage = new Storage();

async function downloadPublicFile() {
  const options = {
    destination: destFileName,
  };

  // Download public file.
  await storage.bucket(bucketName).file(srcFileName).download(options);

  console.log(
    `Downloaded public file ${srcFileName} from bucket name ${bucketName} to ${destFileName}`
  );
}

downloadPublicFile().catch(console.error);

Python

Para obtener más información, consulta la documentación de referencia de la API Python de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

from google.cloud import storage


def download_public_file(bucket_name, source_blob_name, destination_file_name):
    """Downloads a public blob from the bucket."""
    # bucket_name = "your-bucket-name"
    # source_blob_name = "storage-object-name"
    # destination_file_name = "local/path/to/file"

    storage_client = storage.Client.create_anonymous_client()

    bucket = storage_client.bucket(bucket_name)
    blob = bucket.blob(source_blob_name)
    blob.download_to_filename(destination_file_name)

    print(
        "Downloaded public blob {} from bucket {} to {}.".format(
            source_blob_name, bucket.name, destination_file_name
        )
    )

Ruby

Para obtener más información, consulta la documentación de referencia de la API Ruby de Cloud Storage.

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Para obtener más información, consulta el artículo Configurar la autenticación para bibliotecas de cliente.

def download_public_file bucket_name:, file_name:, local_file_path:
  # The name of the bucket to access
  # bucket_name = "my-bucket"

  # The name of the remote public file to download
  # file_name = "publicfile.txt"

  # The path to which the file should be downloaded
  # local_file_path = "/local/path/to/file.txt"

  require "google/cloud/storage"

  storage = Google::Cloud::Storage.anonymous
  bucket  = storage.bucket bucket_name, skip_lookup: true
  file    = bucket.file file_name

  file.download local_file_path

  puts "Downloaded public object #{file.name} from bucket #{bucket} to #{local_file_path}"
end

Siguientes pasos

• Consulta algunos de los conjuntos de datos públicos que ofrece Cloud Storage.

• Consulta cómo compartir un objeto públicamente.
• Consulta las opciones para controlar el acceso a tus datos.
• Controla el acceso a tus datos mediante permisos de gestión de identidades y accesos.
• Descarga objetos de un segmento.