Skip to content

Add an example of "how to make a file public" in the docs #350

Closed
Closed
Add an example of "how to make a file public" in the docs#350
Assignees
stephenplusplus
Labels
🚨This issue needs some love.api: storageIssues related to the Cloud Storage API.triage meI really want to be triaged.
Milestone
Storage Stable

Description

@jgeewax
jgeewax
opened on Jan 15, 2015

I've heard from a lot of people that this is the most common request, so it'd be really cool if we had an example in our docs.

ie:

To make an object publicly readable, you might do:

var storage = gcloud.storage();
var albums = storage.bucket('albums');

albums.acl.add({
  scope: 'allUsers',
  permission: Storage.acl.READER_ROLE
}, function(err, aclObject) {});

Activity

  1. jgeewax
    added
    enhancement
    docs
    on Jan 15, 2015

  2. ryanseys commented on Jan 18, 2015

    @ryanseys
    ryanseys
    on Jan 18, 2015
    Contributor

    Yes 👍 absolutely. This is implemented as a simple check-box in the google developer console. What about even a dedicated function for this such as:

    albums.acl.makePublic(function() {}); // set to allUsers reader
albums.acl.makePrivate(function() {}); // set to no permissions (default)

  3. jgeewax commented on Jan 20, 2015

    @jgeewax
    jgeewax
    on Jan 20, 2015
    ContributorAuthor

    Somewhat dependent on what we expose per #351

  4. stephenplusplus
    added
    api: storageIssues related to the Cloud Storage API.
    on Jan 20, 2015

  5. stephenplusplus commented on Jan 20, 2015

    @stephenplusplus
    stephenplusplus
    on Jan 20, 2015
    Contributor

    Integrating makePublic and makePrivate over in #351. Merged #357 to address the lacking docs issue.

  6. stephenplusplus
    closed this as completedon Jan 20, 2015
  7. jgeewax
    added this to the Storage Stable milestone on Feb 2, 2015
  8. yoshi-automation
    added
    triage meI really want to be triaged.
    🚨This issue needs some love.
    on Apr 6, 2020
  9. JustinBeckwith
    assigned
    stephenplusplus
    on Feb 1, 2021
  10. chingor13
    added a commit that references this issue on Aug 22, 2022

    chore: release 3.4.0 (#350)

    a355399
  11. sofisl
    added a commit that references this issue on Sep 16, 2022

    chore(deps): update dependency mocha to v8 (#350)

    ca97a08
  12. sofisl
    added 2 commits that reference this issue on Oct 5, 2022

    chore(deps): update dependency mocha to v8 (#350)

    976771a

    chore(deps): update dependency mocha to v8 (#350)

    ec3a8b6

  13. 30 remaining items

  14. sofisl
    added a commit that references this issue on Jan 27, 2026

    docs: update readme badges (#350)

    62b3256
  15. GautamSharda
    added a commit that references this issue on Feb 2, 2026

    build: switch to GitHub magic proxy (#350)

    205668c
  16. sofisl
    added a commit that references this issue on Feb 3, 2026

    docs: update contributing path in README (#350)

    771c61c
  17. GautamSharda
    added a commit that references this issue on Feb 3, 2026

    build: switch to GitHub magic proxy (#350)

    86e88fe
  18. sofisl
    added a commit that references this issue on Feb 4, 2026

    chore(deps): update dependency typescript to ~3.6.0 (#350)

    0ae9807
  19. GautamSharda
    added a commit that references this issue on Feb 5, 2026

    chore(deps): upgrade to gts 1.0.0 (#350)

    84b1ab7
  20. GautamSharda
    added a commit that references this issue on Feb 23, 2026

    chore(deps): upgrade to gts 1.0.0 (#350)

    58409a4
  21. sofisl
    added a commit that references this issue on Feb 24, 2026

    fix(deps): update dependency google-gax to ^0.20.0 (#350)

    ce37e11
  22. GautamSharda
    added 2 commits that reference this issue on Feb 25, 2026

    chore: upgrade to Node 14 (#350)

    5f3c30a

    chore(deps): upgrade to gts 1.0.0 (#350)

    30b6732
  23. sofisl
    added a commit that references this issue on Feb 26, 2026

    feat(transaction): add backup backoff delay (#350)

    96cd091
  24. codyoss
    added a commit that references this issue on Mar 5, 2026

    chore: update owlbot-nodejs dependencies (#350)

    ace6352
  25. sofisl
    added a commit that references this issue on Mar 5, 2026

    chore: migrate code from googleapis/gcp-metadata (#53)

    fa9a454
  26. GautamSharda
    added a commit that references this issue on Mar 12, 2026

    Release @google-cloud/common v0.30.0 (#350)

    0d461b8
  27. thiyaguk09
    added a commit that references this issue on Mar 18, 2026

    samples: update dependency @google-cloud/storage to v2 (googleapis#350)

    516c171
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

🚨This issue needs some love.api: storageIssues related to the Cloud Storage API.triage meI really want to be triaged.

Type

No type

Projects

No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions