Accedere ai dati pubblici

Alcuni dati archiviati in Cloud Storage sono configurati in modo da essere letti da chiunque in qualsiasi momento. A questi dati pubblici è possibile accedere in diversi modi, a seconda di come vuoi utilizzarli.

Link API

Nota: l'accesso a questo link non richiede l'autenticazione. È adatto, ad esempio, come link in una pagina web o per il download con uno strumento a riga di comando come cURL.

1. Recupera il nome dell'oggetto pubblico e del bucket che lo memorizza.

2. Utilizza il seguente URI per accedere a un oggetto nel bucket:

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

Ad esempio, il bucket pubblico di Google gcp-public-data-landsat contiene il set di dati pubblico Landsat. Puoi collegarti all'oggetto condiviso pubblicamente LC08/01/001/003/LC08_L1GT_001003_20140812_20170420_01_T2/LC08_L1GT_001003_20140812_20170420_01_T2_B3.TIF con il link:

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: per accedere ai dati pubblici con la console Google Cloud devi accedere con un account utente. Il metodo descritto nella scheda Link API offre il modo più ampiamente applicabile per accedere ai singoli oggetti pubblici. Il metodo descritto nella scheda Riga di comando fornisce il modo più efficiente per accedere alle raccolte di dati.

1. Recupera il nome dell'oggetto pubblico e del bucket che lo memorizza.

2. Utilizzando un browser web, accedi all'oggetto con il seguente URI (se non hai già eseguito l'accesso, ti verrà chiesto di farlo):

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

3. Se il pubblico ha l'autorizzazione per elencare i contenuti del bucket, puoi elencare tutti gli oggetti del bucket con il seguente URI:

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

Ad esempio, il bucket pubblico di Google gcp-public-data-landsat contiene il set di dati pubblico Landsat. Puoi accedere al bucket con:

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

Riga di comando

Nota: l'accesso ai dati pubblici con l'gcloud CLI non richiede autenticazione. Questo strumento è adatto per l'accesso generale ai bucket che contengono dati pubblici elencabili pubblicamente.

1. Se non hai l'interfaccia alla gcloud CLI, segui queste istruzioni per installarla.

   • Se non vuoi eseguire l'autenticazione durante l'installazione di gcloud CLI, salta il passaggio di esecuzione del comando gcloud init esegui invece il seguente comando:

     gcloud config set auth/disable_credentials True

2. Recupera il nome dell'oggetto pubblico e del bucket che lo memorizza.

3. Se il pubblico ha l'autorizzazione a elencare i contenuti del bucket, puoi elencare alcuni o tutti gli oggetti contenuti nel bucket utilizzando il comando ls.

   Ad esempio, il bucket pubblico di Google gcp-public-data-landsat contiene il set di dati pubblico Landsat. Puoi elencare gli oggetti con il prefissoLC08/01/001/003/LC con il seguente comando:

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

   Nota: le shell (come bash e zsh) possono tentare di espandere i caratteri jolly prima di passare gli argomenti alla gcloud CLI. Per evitare questi problemi, racchiudi l'espressione con caratteri jolly tra virgolette singole (su Linux) o doppie (su Windows). Per ulteriori informazioni, consulta Comportamento potenzialmente sorprendente quando si utilizzano caratteri jolly.

4. Scarica oggetti pubblici specifici contenuti nel bucket utilizzando il comando cp.

   Ad esempio, il seguente comando scarica un file dal bucket gcp-public-data-landsat nella tua directory locale:

   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 .

Librerie client

C++

Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage C++.

Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.

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#

Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage C#.

Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.

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

Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Go.

Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.

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

Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Java.

Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.

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

Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.

Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.

/**
 * 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

Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Python.

Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.

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

Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.

Per autenticarti a Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configurare l'autenticazione per le librerie client.

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

Passaggi successivi

• Esplora alcuni dei set di dati pubblici forniti da Cloud Storage.

• Scopri come condividere pubblicamente un oggetto.
• Scopri le opzioni per controllare l'accesso ai tuoi dati.
• Controlla l'accesso ai tuoi dati utilizzando le autorizzazioni IAM.
• Scaricare oggetti da un bucket.