公開您的資料

本頁說明如何將您持有的物件設為可公開讀取。要瞭解如何存取已設為公開的資料，請參閱存取公開資料一文。

附註：當物件公開共用時，只要物件為公開，有該物件 URI 的任何使用者就都可以存取物件。

將個別物件設成可公開讀取

重要事項：如果您已在值區上啟用僅值區政策，就無法使用這些步驟 ，而是可以在值區層級授予公開讀取權，或使用已簽署的網址。

如何將個別物件設成可公開讀取：

主控台

1. 在 Google Cloud Platform 主控台中開啟 Cloud Storage 瀏覽器。
   開啟 Cloud Storage 瀏覽器

2. 在值區清單中，找到包含您要設為公開的物件的值區名稱，然後點選這個名稱，前往該物件的所在位置 (如果位於子目錄中)。

3. 針對您想要設為公開的物件，點選對應的下拉式選單。

   點選物件列最右側的三個垂直圓點，下拉式選單就會出現。

4. 在下拉式選單中，選取 [Edit permissions] (編輯權限)。

5. 在出現的重疊視窗中，按一下 [+ Add item] (+ 新增項目) 按鈕。

6. 為「allUsers」新增權限。

   • 為「Entity」(實體) 選取 [User] (使用者)。
   • 為「Name」(名稱) 輸入「allUsers」。
   • 為「Access」(存取權) 選取 [Reader](讀取者)。

7. 按一下 [Save] (儲存)。

公開共用後，「public access」(公開存取權) 欄中會出現連結圖示。您可以按一下這個圖示，來取得物件的網址。

gsutil

使用 gsutil acl ch 指令，並將 [VALUES_IN_BRACKETS] 替換為適當的值：

gsutil acl ch -u AllUsers:R gs://[BUCKET_NAME]/[OBJECT_NAME]

如果成功，回應會類似以下範例：

Updated ACL on gs://[BUCKET_NAME]/[OBJECT_NAME]

程式碼範例

C++

詳情請參閱 Cloud Storage C++ API 參考說明文件。

前往 GitHub 查看 意見回饋

namespace gcs = google::cloud::storage;
using ::google::cloud::StatusOr;
[](gcs::Client client, std::string bucket_name, std::string object_name) {
  StatusOr<gcs::ObjectMetadata> updated = client.PatchObject(
      bucket_name, object_name, gcs::ObjectMetadataPatchBuilder(),
      gcs::PredefinedAcl::PublicRead());

  if (!updated) {
    throw std::runtime_error(updated.status().message());
  }

  std::cout << "Object updated. The full metadata after the update is: "
            << *updated << "\n";
}

C#

詳情請參閱 Cloud Storage C# API 參考說明文件。

前往 GitHub 查看 意見回饋

private void MakePublic(string bucketName, string objectName)
{
    var storage = StorageClient.Create();
    var storageObject = storage.GetObject(bucketName, objectName);
    storageObject.Acl = storageObject.Acl ?? new List<ObjectAccessControl>();
    storage.UpdateObject(storageObject, new UpdateObjectOptions
    {
        PredefinedAcl = PredefinedObjectAcl.PublicRead
    });
    Console.WriteLine(objectName + " is now public and can be fetched from " +
        storageObject.MediaLink);
}

Go

詳情請參閱 Cloud Storage Go API 參考說明文件。

前往 GitHub 查看 意見回饋

acl := client.Bucket(bucket).Object(object).ACL()
if err := acl.Set(ctx, storage.AllUsers, storage.RoleReader); err != nil {
	return err
}

Java

詳情請參閱 Cloud Storage Java API 參考說明文件。

前往 GitHub 查看 意見回饋

BlobId blobId = BlobId.of(bucketName, blobName, blobGeneration);
Acl acl = storage.createAcl(blobId, Acl.of(User.ofAllUsers(), Role.READER));

Node.js

詳情請參閱 Cloud Storage Node.js API 參考說明文件。

前往 GitHub 查看 意見回饋

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

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

/**
 * TODO(developer): Uncomment the following lines before running the sample.
 */
// const bucketName = 'Name of a bucket, e.g. my-bucket';
// const filename = 'File to make public, e.g. file.txt';

// Makes the file public
await storage
  .bucket(bucketName)
  .file(filename)
  .makePublic();

console.log(`gs://${bucketName}/${filename} is now public.`);

PHP

詳情請參閱 Cloud Storage PHP API 參考說明文件。

前往 GitHub 查看 意見回饋

use Google\Cloud\Storage\StorageClient;

/**
 * Make an object publically accessible.
 *
 * @param string $bucketName the name of your Cloud Storage bucket.
 * @param string $objectName the name of your Cloud Storage object.
 *
 * @return void
 */
function make_public($bucketName, $objectName)
{
    $storage = new StorageClient();
    $bucket = $storage->bucket($bucketName);
    $object = $bucket->object($objectName);
    $object->update(['acl' => []], ['predefinedAcl' => 'PUBLICREAD']);
    printf('gs://%s/%s is now public' . PHP_EOL, $bucketName, $objectName);
}

Python

詳情請參閱 Cloud Storage Python API 參考說明文件。

前往 GitHub 查看 意見回饋

def make_blob_public(bucket_name, blob_name):
    """Makes a blob publicly accessible."""
    storage_client = storage.Client()
    bucket = storage_client.get_bucket(bucket_name)
    blob = bucket.blob(blob_name)

    blob.make_public()

    print('Blob {} is publicly accessible at {}'.format(
        blob.name, blob.public_url))

Ruby

詳情請參閱 Cloud Storage Ruby API 參考說明文件。

前往 GitHub 查看 意見回饋

# project_id  = "Your Google Cloud project ID"
# bucket_name = "Your Google Cloud Storage bucket name"
# file_name   = "Name of file in Google Cloud Storage to make public"

require "google/cloud/storage"

storage = Google::Cloud::Storage.new project_id: project_id
bucket  = storage.bucket bucket_name
file    = bucket.file file_name

file.acl.public!

puts "#{file.name} is publicly accessible at #{file.public_url}"

REST API

JSON API

1. 從 OAuth 2.0 Playground 取得授權存取憑證。將 Playground 設為使用您自己的 OAuth 憑證。
2. 建立包含下列資訊的 .json 檔案：

{
"entity": "allUsers",
"role": "READER"
}

3. 透過 Insert ACL 要求，使用 cURL 呼叫 JSON API，並將 [VALUES_IN_BRACKETS] 替換為適當的值：

   curl -X POST --data-binary @[JSON_FILE_NAME].json \
       -H "Authorization: Bearer [OAUTH2_TOKEN]" \
       -H "Content-Type: application/json" \
       "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]/o/[OBJECT_NAME]/acl"

XML API

1. 從 OAuth 2.0 Playground 取得授權存取憑證。將 Playground 設為使用您自己的 OAuth 憑證。
2. 建立包含下列資訊的 .xml 檔案：

<AccessControlList>
<Entries>
    <Entry>
      <Scope type="AllUsers"/>
      <Permission>READ</Permission>
    </Entry>
</Entries>
</AccessControlList>

3. 透過 Set Object ACL 要求，使用 cURL 呼叫 XML API，並將 [VALUES_IN_BRACKETS] 替換為適當的值：

   curl -X PUT --data-binary @[XML_FILE_NAME].xml \
       -H "Authorization: Bearer [OAUTH2_TOKEN]" \
       "https://storage.googleapis.com/[BUCKET_NAME]/[OBJECT_NAME]?acl"

將物件群組設為可供公開讀取

如何將值區中的所有物件設為可公開讀取：

主控台

1. 在 Google Cloud Platform 主控台中開啟 Cloud Storage 瀏覽器。
   開啟 Cloud Storage 瀏覽器

2. 在值區清單中，找到您要設為公開的值區名稱，然後點選這個名稱。

3. 選取靠近頁面上方的 [Permissions] (權限) 分頁標籤。

4. 按一下 [Add members] (新增成員) 按鈕。

   隨即顯示「Add members」(新增成員) 對話方塊。

5. 在「New members」(新增成員) 欄位中，輸入 allUsers。

6. 在「Roles」(角色) 下拉式選單中，選取 [Storage](儲存空間) 子選單，然後點選 [Storage Object Viewer] (Storage 物件檢視者) 選項。

7. 按一下 [Save] (儲存)。

公開共用後，「public access」(公開存取權) 欄中會出現各個物件的連結圖示。點選這個圖示即可取得物件的網址。

gsutil

使用 gsutil iam ch 指令，並將 [VALUES_IN_BRACKETS] 替換為適當的值：

gsutil iam ch allUsers:objectViewer gs://[BUCKET_NAME]

REST API

JSON API

1. 從 OAuth 2.0 Playground 取得授權存取憑證。將 Playground 設為使用您自己的 OAuth 憑證。
2. 建立包含下列資訊的 .json 檔案：

{
  "bindings":[
    {
      "role": "roles/storage.objectViewer",
      "members":["allUsers"]
    }
  ]
}

3. 透過 PUT setIamPolicy 要求，使用 cURL 呼叫 JSON API，並將 [VALUES_IN_BRACKETS] 替換為適當的值：

   curl -X PUT --data-binary @[JSON_FILE_NAME].json \
       -H "Authorization: Bearer [OAUTH2_TOKEN]" \
       -H "Content-Type: application/json" \
       "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]/iam"

XML API

XML API 不支援將值區中的所有物件設為可公開讀取，請改用 gsutil 或 JSON API。

後續步驟

• 存取已設為公開的資料。
• 瞭解值區和物件適用的更多存取權控管選項。