Accedi ai dati pubblici

Alcuni dati archiviati in Cloud Storage sono configurati in modo che siano leggibili da chiunque in qualsiasi momento. È possibile accedere a questi dati pubblici in diversi modi, a seconda di come vuoi utilizzarli.

Link all'API

Recupera il nome dell'oggetto pubblico e del bucket in cui è archiviato l'oggetto.
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 creare un collegamento all'oggetto condiviso pubblicamente LC08/01/001/003/LC08_L1GT_001003_20140812_20170420_01_T2/LC08_L1GT_001003_20140812_20170420_01_T2_B3.TIF utilizzando 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

Recupera il nome dell'oggetto pubblico e del bucket in cui è archiviato l'oggetto.
Utilizzando un browser web, accedi all'oggetto con il seguente URI (ti verrà chiesto di eseguire l'accesso se non l'hai ancora fatto):

https://console.cloud.google.com/storage/browser/_details/BUCKET_NAME/OBJECT_NAME
Se il pubblico dispone dell'autorizzazione per elencare i contenuti del bucket, puoi elencare tutti gli oggetti nel 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

Se non hai gcloud CLI, segui queste istruzioni per installarlo.
- Durante l'installazione di gcloud CLI, se non vuoi eseguire l'autenticazione, salta il passaggio dell'esecuzione del comando gcloud init ed esegui invece questo comando:
```
gcloud config set auth/disable_credentials True
```
Recupera il nome dell'oggetto pubblico e del bucket in cui è archiviato l'oggetto.
Se l'autorizzazione per elencare i contenuti del bucket viene concessa al pubblico, 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 prefisso LC08/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 gcloud CLI. Per evitare questi problemi, inserisci l'espressione con caratteri jolly tra virgolette singole (su Linux) o doppie (su Windows). Per ulteriori informazioni, consulta la sezione Comportamento potenzialmente sorprendente quando utilizzi i caratteri jolly.
Scarica oggetti pubblici specifici contenuti nel bucket utilizzando il comando cp.

Ad esempio, il comando seguente 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 maggiori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.

Per eseguire l'autenticazione in Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.

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 maggiori informazioni, consulta la documentazione di riferimento dell'API C# di Cloud Storage.


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 maggiori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Storage.

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 maggiori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.


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 maggiori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.

/**
 * 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 maggiori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.

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 maggiori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Storage.

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 dati utilizzando le autorizzazioni IAM.
Scarica oggetti da un bucket.