公開您的資料

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

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

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

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

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

Console

1. 在 Google Cloud Platform Console 中開啟 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. 使用 cURL，透過 Insert ACL 要求，呼叫 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. 使用 cURL 透過 Set Object ACL 要求，呼叫 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"

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

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

Console

1. 在 Google Cloud Platform Console 中開啟 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. 使用 cURL 透過 PUT 值區要求呼叫 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。

注意：roles/storage.objectViewer 具備列出值區中物件的權限。如果不想授權公開列出物件，請使用 roles/storage.legacyObjectReader。

後續步驟

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