Accede 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 maneras, según cómo desees trabajar con los datos.

Vínculo de la API

Nota: El acceso a este vínculo no requiere autenticación. Por ejemplo, es adecuado como un vínculo en una página web o para descargar con una herramienta de línea de comandos como cURL.

1. Obtén el nombre del objeto público y el bucket que almacena el objeto.

2. Usa el siguiente URI para acceder a un objeto en el bucket:

   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úblicos Landsat dataset. Puedes vincular 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 este vínculo:

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

Console

Nota: Para acceder a los datos públicos con la consola de Google Cloud, debes acceder con una cuenta de usuario. El método descrito en la pestaña de vínculo a la API proporciona la forma más amplia de acceder a objetos públicos individuales. El método descrito en la pestaña de Línea de comandos proporciona la forma más eficiente de acceder a las colecciones de datos.

1. Obtén el nombre del objeto público y el bucket que almacena el objeto.

2. Con un navegador web, accede al objeto con el siguiente URI (se te pedirá acceder si aún no lo hiciste):

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

3. Si el público tiene permiso para enumerar el contenido del bucket, puedes enumerar todos los objetos en el bucket 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úblicos Landsat dataset. Puedes acceder al bucket con el siguiente vínculo:

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

Línea de comandos

Nota: El acceso a los datos públicos con gcloud CLI no requiere autenticación. Esta herramienta es adecuada para el acceso general a buckets que contienen datos públicos que se pueden enumerar de forma pública.

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

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

     gcloud config set auth/disable_credentials True

2. Obtén el nombre del objeto público y el bucket que almacena el objeto.

3. Si se otorga al público el permiso para enumerar el contenido del bucket, puedes enumerar algunos o todos los objetos contenidos en el bucket a través del uso del comando ls.

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

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

   Nota: Las shells (como bash y zsh) pueden intentar expandir los comodines antes de pasar los argumentos a gcloud CLI. Para evitar estos problemas, encierra la expresión de comodín con comillas simples (en Linux) o comillas dobles (en Windows). Para obtener más información, consulta Posible comportamiento cuando se usan comodines.

4. Descarga objetos públicos específicos contenidos en el bucket mediante el comando cp.

   Por ejemplo, el siguiente comando descarga un archivo del depósito gcp-public-data-landsat a 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 cliente

C++

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

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas 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#

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

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas 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

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

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.

import (
	"context"
	"fmt"
	"io"
	"io/ioutil"
	"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 := ioutil.ReadAll(rc)
	if err != nil {
		return nil, fmt.Errorf("ioutil.ReadAll: %w", err)
	}
	fmt.Fprintf(w, "Blob %v downloaded.\n", object)
	return data, nil
}

Java

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

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.

import com.google.cloud.storage.Blob;
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();

    Blob blob = storage.get(BlobId.of(bucketName, publicObjectName));
    blob.downloadTo(destFilePath);

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

Node.js

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

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas 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

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

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas 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

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

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas 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

¿Qué sigue?

• Explora algunos de los conjuntos de datos públicos que proporciona Cloud Storage.

• Aprende a compartir públicamente un objeto.
• Conoce las opciones para controlar el acceso a tus datos.
• Controla el acceso a tus datos mediante permisos de IAM.
• Descarga objetos de un bucket.