Auf öffentliche Daten zugreifen

Einige in Cloud Storage gespeicherte Daten sind konfiguriert, damit sie jederzeit für jeden lesbar sind. Auf diese öffentlichen Daten kann auf verschiedene Arten zugegriffen werden, je nachdem, wie Sie mit diesen Daten arbeiten möchten.

API-Link

Rufen Sie den Namen des öffentlichen Objekts und den Bucket ab, in dem das Objekt gespeichert ist.
Verwenden Sie den folgenden URI, um auf ein Objekt im Bucket zuzugreifen:

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

Der öffentliche Google-Bucket gcp-public-data-landsat enthält beispielsweise das öffentliche Landsat-Dataset. Mit dem folgenden Link können Sie eine Verknüpfung zum öffentlich freigegebenen Objekt LC08/01/001/003/LC08_L1GT_001003_20140812_20170420_01_T2/LC08_L1GT_001003_20140812_20170420_01_T2_B3.TIF herstellen:

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

Rufen Sie den Namen des öffentlichen Objekts und den Bucket ab, in dem das Objekt gespeichert ist.
Greifen Sie über einen Webbrowser mit dem folgenden URI auf das Objekt zu. Sie werden aufgefordert, sich anzumelden, wenn Sie nicht bereits angemeldet sind:

https://console.cloud.google.com/storage/browser/_details/BUCKET_NAME/OBJECT_NAME
Wenn die Öffentlichkeit die Berechtigung zum Auflisten des Inhalts des Buckets hat, können Sie alle Objekte im Bucket mit dem folgenden URI auflisten:

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

Der öffentliche Google-Bucket gcp-public-data-landsat enthält beispielsweise das öffentliche Landsat-Dataset. Auf diesen Bucket können Sie folgendermaßen zugreifen:

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

Befehlszeile

Wenn Sie die gcloud CLI nicht haben, folgen Sie dieser Anleitung, um sie zu installieren.
- Wenn Sie sich bei der Installation der gcloud CLI nicht authentifizieren möchten, überspringen Sie den Schritt des Befehls gcloud init und führen Sie stattdessen den folgenden Befehl aus:
```
gcloud config set auth/disable_credentials True
```
Rufen Sie den Namen des öffentlichen Objekts und den Bucket ab, in dem das Objekt gespeichert ist.
Wenn die Berechtigung zum Auflisten des Inhalts des Buckets der Öffentlichkeit gewährt ist, können Sie einige oder alle im Bucket enthaltenen Objekte mit dem Befehl ls auflisten.

Der öffentliche Google-Bucket gcp-public-data-landsat enthält beispielsweise das öffentliche Landsat-Dataset. Sie können Onjekte mit dem Präfix LC08/01/001/003/LC mit folgendem Befehl auflisten:
```
gcloud storage ls --recursive gs://gcp-public-data-landsat/LC08/01/001/003/LC*
```
Hinweis: Shells (wie bash und zsh) können versuchen, Platzhalter zu erweitern, bevor die Argumente an die gcloud CLI übergeben werden. Setzen Sie den Ausdruck mit Platzhalter zur Vermeidung dieser Probleme in einfache Anführungszeichen (unter Linux) oder doppelte Anführungszeichen (unter Windows). Weitere Informationen finden Sie unter Potenziell unerwartetes Verhalten bei der Verwendung von Platzhaltern.
Einzelne im Bucket enthaltene öffentliche Objekte können Sie mit dem Befehl cp herunterladen.

Mit dem folgenden Befehl wird beispielsweise eine Datei aus dem Bucket gcp-public-data-landsat in Ihr lokales Verzeichnis heruntergeladen:
```
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 .
```

Clientbibliotheken

C++

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.

Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.

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#

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C# API.


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

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Go API.

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

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.


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

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Node.js API.

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

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Python API.

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

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Ruby API.

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

Nächste Schritte

Öffentliche Datasets von Cloud Storage ansehen